Connect a new app by supplying its credentials in auth (required keys vary by app — see the request examples).
Apps that validate immediately connect and trigger an initial sync; apps that require browser consent are finished in the Lumos UI. The response returns the connected app; list your API-managed apps via the Apps API (GET /v1/apps?connection_source=API&disconnected=false).
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
400Bad request — the request could not be processed. Common causes: missing or malformed credentials, an unknown app_class_id, or an invalid configuration value. See the detail field for the specific reason.
403Forbidden — the caller lacks permission to manage apps on this domain.
409Conflict — an instance for this app already exists in the domain.
501Not implemented — this app does not support the requested operation.
502Bad gateway — the third-party service rejected the credentials, or the post-connect sync failed.