Connect a channel

POST 
/v1/projects/:project_id/channels

Connect a channel. The required fields depend on channel; no credential is ever returned. Discord (channel: discord) — supply application_id and bot_token, plus the modes selecting which Gateway flows to serve (direct messages, and/or @mention-opens-a-thread). Returns 501 when the deployment has no CHANNEL_TOKEN_KEY configured. WhatsApp (default) — one of two credential paths, both filling the same write-only secret:

• BYOT (credential_source: byot, default) — supply phone_number_id and access_token from your own Meta app.

• Embedded signup (credential_source: embedded_signup) — supply code and waba_id (and optionally pin) from the Meta popup; naturali exchanges the code for the token and subscribes its app to the WABA, so the customer never hands over a token. Returns 501 on deployments where Meta App credentials are not configured.

Request

Responses

201

Channel created.

400

The request was malformed or failed validation.

401

Missing or invalid credentials.

404

The resource does not exist (existence is not leaked).

409

The request conflicts with the resource's current state.

501

The requested path is not enabled on this deployment (e.g. embedded signup before Meta App credentials are configured, or a Discord channel before CHANNEL_TOKEN_KEY is set).

502

The upstream runtime, or Meta, could not complete the operation.