Create a new brand

POST

/resellers/{reseller}/brands

Last modified:2026-02-03 09:24:01

Create a new brand configuration with styling properties. The brand is identified by the unique combination of hostname + reseller + brand-name.

If currently-active is set to true, all other brands for this hostname+reseller will be automatically deactivated (only one active brand per hostname+reseller).

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/json

Examples

Responses

🟢201

application/json

Brand created successfully

Body

🟠400

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://awqacore01.crexendocloud.com/ns-api/v2/resellers//brands' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "hostname": "portal.acmecorp.com",
    "brand-name": "ACME Blue Theme",
    "description": "string",
    "currently-active": false,
    "color-primary": "#1E40AF",
    "color-secondary": "#7C3AED",
    "color-success": "#059669",
    "color-info": "#0284C7",
    "color-error": "#DC2626",
    "color-warning": "#D97706",
    "font-family": "Inter, sans-serif",
    "font-size-pixels": 16,
    "margin-pixels": 16,
    "padding-pixels": 16,
    "powered-by": "Powered by ACME Corp",
    "email-sender": "noreply@acmecorp.com"
}'

Response Example

201 - Example 1

{
    "id": "285ed3196c8c1ae900033e5295026c4d",
    "hostname": "portal.acmecorp.com",
    "reseller": "acme-reseller",
    "brand-name": "ACME Blue Theme",
    "description": "string",
    "currently-active": true,
    "color-primary": "string",
    "color-secondary": "string",
    "color-success": "string",
    "color-info": "string",
    "color-error": "string",
    "color-warning": "string",
    "font-family": "string",
    "font-size-pixels": 0,
    "margin-pixels": 0,
    "padding-pixels": 0,
    "powered-by": "string",
    "email-sender": "user@example.com",
    "created": "2019-08-24T14:15:22.123Z",
    "modified": "2019-08-24T14:15:22.123Z",
    "assets": {
        "logo": {
            "id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
            "brand-id": "285ed3196c8c1ae900033e5295026c4d",
            "filename": "acme-logo.png",
            "mime-type": "image/png",
            "file-size": 45678,
            "width": 200,
            "height": 80
        },
        "banner": {
            "id": "b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7",
            "brand-id": "285ed3196c8c1ae900033e5295026c4d",
            "filename": "acme-banner.jpg",
            "mime-type": "image/jpeg",
            "file-size": 123456,
            "width": 1200,
            "height": 300
        }
    },
    "matched-hostname": "portal.acmecorp.com"
}

Modified at 2026-02-03 09:24:01

List all brands for a reseller

Get all brands for reseller + hostname