Apps

Create a child app for the current tenant actor (v2)

Auth: Tenant Actor

Creates an app under the current tenant / parent app context. Supports User JWT and B2B Server JWT.

post/v2/apps

Request

  • Base URL: https://api.chat.ethora.com
  • URL: https://api.chat.ethora.com/v2/apps
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Request body

displayNamestring required

Human-readable app name shown in the admin panel, sign-up screens, and chat headers. 3-100 chars.

domainNamestring

Subdomain used for the hosted app at <domainName>.<rootDomain>. Alphanumeric only (no dashes); must be unique across the platform.

appTaglinestring

Short marketing line shown beneath the display name on the sign-up screen. Free-form.

logoImagestring

Main app logo. POST/PUT accept either a file upload (multipart) or a URL (JSON). 1:1 ratio recommended, displayed at 120x120 px in the admin panel.

sublogoImagestring

Optional secondary logo / favicon. Same input shapes as logoImage.

primaryColorstring

Brand colour as a 6-digit hex string (e.g. #0052CD). Used as the accent throughout the chat UI.

bundleIdstring

iOS/Android bundle identifier in reverse-DNS form (e.g. com.acme.chat). Required for native push notifications.

createDefaultChatboolean

If true, the app will be seeded with a "Main chat" default chat room available to all users. Used when creating new apps manually from within admin panel.

Response

ok

Changes

No recorded changes to this operation across all 1 revision of this API.