Branding

Per-account white-label: domain, logos, theme, and sender-email branding.

Per-account white-label: domain, logos, theme, and sender-email branding.

Prerequisites

  • A bearer token in the Authorization header. Any endpoint that needs no token says so on its own page.
  • The id of each record the call targets. Every endpoint page lists the ids it needs.

Errors

StatusMeaning
401The bearer token is missing, expired or invalid
403The token is valid but the record sits outside your account
422The request failed validation — the response names the fields
500Unexpected server error

Individual endpoints may return more; each page lists its own.

Endpoints

White Label - Resolve branding (public/login)

POST — Resolve white-label branding (logo, login logo, favicon, title, white-label URL, status) and saved theme options for a company so the SPA can account the login screen before authentication.

Open →

White Label - Get data (data resolver)

POST — Resolve the white-label branding/domain config for a company — looked up by explicit company_id, by referral_code (resolved to its company), or, if neither is given, inferred from the request Referer host (subdomain + domain matched against domain_prefix/domain_name).

Open →

White Label - Get (partner get)

POST — Returns the authenticated user's white-label configuration row (logos, favicon, domain prefix/name, sub-domain verification status), theme settings, and the email-templates-enabled flag for editing in the partner UI.

Open →

White Label - Update (domain + branding upload)

POST — Sets up or updates your own account's white-label branding: the custom subdomain, the display title, and up to four account images.

Open →

White Label - Save theme options

POST — Save the theme options for one account, and optionally uploads a theme logo at the same time.

Open →

White Label - Delete logo / favicon

POST — Remove one branding image from a company's white-label config by nulling the matching column (favicon, logo, login_logo, or mobile_logo) on the latest RsWhiteLabel row and saving.

Open →

Email White Label - Get (Mandrill status)

POST — Returns the company's email white-label record plus live Mandrill verification status.

Open →

Email White Label - Add / verify

POST — Create or update the email white-label sender for a company and verifies its domain via Mandrill.

Open →

Theme Options - Save (options + logo)

POST — Create or update the latest RsUserThemeSetting for a company (recording the authenticated user as author) with the supplied theme_options JSON, and — when a logo_image file is sent — stores it to S3 and writes it onto the company's RsWhiteLabel logo.

Open →


Did this page help you?