Create Brand

Creates a new brand configuration.

You can have only one brand configured for a project.

📘 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.

POST /management/v1/projects/{projectId}/branding

Create Brand

cURL

curl --request POST \
  --url https://{cluster}.voucherify.io/management/v1/projects/{projectId}/branding \
  --header 'Content-Type: application/json' \
  --header 'X-Management-Id: <api-key>' \
  --header 'X-Management-Token: <api-key>' \
  --data '
{
  "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": "voucherify.io"
  },
  "address": {
    "street": "Porcelanowa 23",
    "city": "Katowice",
    "postal": "43-246",
    "state": null,
    "country": "Poland"
  },
  "contact": {
    "email": "[e-mail]",
    "phone": null
  }
}
'

200

{
  "id": "brd_0eb55234024e226d9d",
  "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": "voucherify.io"
  },
  "address": {
    "street": "Porcelanowa 23",
    "city": "Katowice",
    "postal": "43-246",
    "state": null,
    "country": "Poland"
  },
  "contact": {
    "email": "[e-mail]",
    "phone": 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"

Body

application/json

Defines a brand configuration.

Request body schema for POST /management/v1/projects/{projectId}/branding.

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

Response

200

application/json

Returns the details about the brand configuration.

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

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