Create App
Create an App: the connection to one external system (a CRM, calendar, support desk, and so on), holding its credentials and settings. Providers that authenticate with a key, token, or refresh token can be connected in this one call by passing auth_config; the credential is stored encrypted and never returned. Up to 20 apps per provider.
Authorizations
Authentication header containing API key (find it in dashboard). The format is "Bearer YOUR_API_KEY"
Body
App integration category.
crm, calendar, knowledge_base, support, communication Provider name. Must be valid for the App's type; the supported providers per type are listed by list-app-templates.
Display name.
Per-tenant API base URL.
Sub-account id, for providers that scope requests by a sub-account id on a shared host.
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
Response
App created.
App integration category.
crm, calendar, knowledge_base, support, communication Provider name. Must be valid for the App's type; the supported providers per type are listed by list-app-templates.
Connection health of the App, server-managed. not_connected after create or a credential / tenant URL change; connected once verified via OAuth connect, an auth test, or a successful live tool call; error when the provider rejects the credentials (on connect, an auth test, or a live tool call).
not_connected, connected, error Per-tenant API base URL. Set by providers with per-org hosts; omitted by providers on a single global host.
Sub-account id, for providers that scope requests by a sub-account id on a shared host. Omitted by every other provider.
Non-secret auth metadata. Encrypted secret fields are never returned by the API.
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5

