Update Brand

Updates a brand configuration.

Only the fields sent in the request will be updated. The fields omitted in the request will remain unchanged.

📘 White Labelling

The white labelling settings which can be found in Project Settings > Brand Details and which are available only for Enterprise clients as a separate service can be configured only in the user interface.

PUT /management/v1/projects/{projectId}/branding/{brandingId}

Update Brand

cURL

curl --request PUT \
  --url https://{cluster}.voucherify.io/management/v1/projects/{projectId}/branding/{brandingId} \
  --header 'Content-Type: application/json' \
  --header 'X-Management-Id: <api-key>' \
  --header 'X-Management-Token: <api-key>' \
  --data '
{
  "brand": {
    "name": "<string>",
    "privacy_policy_url": "<string>",
    "terms_of_use_url": "<string>",
    "permission_reminder": "<string>",
    "website_url": "<string>"
  },
  "address": {
    "street": "<string>",
    "city": "<string>",
    "postal": "<string>",
    "state": "<string>",
    "country": "<string>"
  },
  "contact": {
    "email": "<string>",
    "phone": "<string>"
  },
  "cockpits": {
    "campaigns_overview_enabled": true,
    "loyalty_enabled": true,
    "gift_cards_enabled": true,
    "coupons_enabled": true,
    "referrals_enabled": true,
    "theme": "orange",
    "use_custom_double_opt_in_redirect_url": true,
    "custom_double_opt_in_redirect_url": "<string>"
  }
}
'

200

{
  "id": "brd_0ead90c940a9deef09",
  "brand": {
    "name": "Voucherify PSA",
    "privacy_policy_url": null,
    "terms_of_use_url": null,
    "permission_reminder": "You are receiving this email because you opted in at our website.",
    "website_url": null
  },
  "address": {
    "street": "Porcelanowa 23",
    "city": "Katowice",
    "postal": "43-246",
    "state": null,
    "country": "Poland"
  },
  "contact": {
    "email": "[e-mail]",
    "phone": null
  },
  "cockpits": {
    "campaigns_overview_enabled": false,
    "loyalty_enabled": true,
    "gift_cards_enabled": true,
    "coupons_enabled": true,
    "referrals_enabled": true,
    "theme": "default",
    "use_custom_double_opt_in_redirect_url": false,
    "custom_double_opt_in_redirect_url": null
  }
}

Authorizations

X-Management-Id · string · header · required

X-Management-Token · string · header · required

Path Parameters

projectId · string · required

Provide the unique identifier of the project.

Example:

"proj_TrlkLiH4"

brandingId · string · required

Provide the unique identifier of the brand configuration.

Example:

"brd_06d06m1944y0630hD4y"

Body

application/json

Defines the brand configuration to be updated.

brand · Brand · object

Defines basic brand details.

Show child attributes

address · Address · object

Defines the address details.

Show child attributes

contact · Contact · object

Defines contact details.

Show child attributes

cockpits · Cockpit · object

Defines customer cockpit details.

Show child attributes

Response

200

application/json

Returns the details about the updated brand configuration.

Response body schema for PUT /management/v1/projects/{projectId}/branding/{brandingId}.

id · string · required

Unique identifier of the brand configuration.

brand · Brand · object · required

Defines basic brand details.

Show child attributes

address · Address · object · required

Defines the address details.

Show child attributes

contact · Contact · object · required

Defines contact details.

Show child attributes

cockpits · Cockpit · object · required

Defines customer cockpit details.

Show child attributes