MCP is live.Set upAsk the community
OmniDimension
Dashboard
DocumentationAPI referenceSDKsMCP
Reseller identity

Save brand identity

Set the brand your client organizations see: your brand name and company name on their emails, and your brand name spoken in their verification calls. The first save creates the brand. Later saves change only the fields you send. Your own emails do not change.

Reseller accounts only. Request access.

POST/reseller/identity/save
Body
5 fields
·

Brand name. Your clients' emails show it and their verification calls speak it. Plain text.

Company name. Plain text.

curl -X POST 'https://backend.omnidim.io/api/v1/reseller/identity/save' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "platform_name": "Acme Voice",
  "company_name": "Acme Ltd",
  "primary_color": "#1976d2",
  "real_email": "hello@acme.example"
}'
Example response
{
  "success": true,
  "can_use_brand_identity": true,
  "can_use_custom_smtp": true,
  "has_identity": true,
  "identity": {
    "platform_name": "Acme Voice",
    "company_name": "Acme Ltd",
    "logo_url": "",
    "primary_color": "#1976d2",
    "real_email": "hello@acme.example"
  },
  "smtp": {
    "configured": false,
    "active": false
  }
}

Authorization

BearerAuth
headerAuthorizationBearer <token>

Bearer token authentication. Obtain your API key from the OmniDimension dashboard.

Request Body

application/json
platform_name?string

Brand name. Your clients' emails show it and their verification calls speak it. Plain text.

Length1 <= length <= 60
company_name?string

Company name. Plain text.

Length1 <= length <= 60
logo_url?string

Public URL of your logo.

primary_color?string

Brand colour as a hex value, for example #1976d2.

real_email?string

Sender and reply-to address on your clients' emails.

Formatemail

Response body

application/json

Response Body

The brand was saved. The body is the full brand state.

application/json

Your brand and custom email server state. The SMTP password is never returned.

success?boolean
can_use_brand_identity?boolean

Whether this account may hold a brand. When false, every write returns 403.

can_use_custom_smtp?boolean

Whether this account may send clients' emails through its own email server.

has_identity?boolean

false until the first save.

identity?

The saved brand. Empty until the first save. Other branding keys can appear.

smtp?

Get brand identity

Read your brand and your custom email server settings. The brand is what your client organizations see: your brand name on their emails, and spoken in their verification calls. Your own emails do not change.

Save custom email server

Send your clients' emails through your own email server, so they come from your domain. The server is checked with a live login before anything is saved. If the login fails, nothing changes and the response is 400 with the reason. Save your brand first.