Skip to main content
POST
Create temporary channel connection link

Autorizaciones

Authorization
string
header
requerido

Server-side tenant-scoped credential created from Build > API Keys.

Encabezados

Idempotency-Key
string
requerido

Stable caller-generated key for this type and intended business. Reuse with the exact input on creation retry; retain attemptId to reconcile. Deduplication lasts 24 hours.

Required string length: 8 - 128
Pattern: ^[A-Za-z0-9._:-]{8,128}$

Cuerpo

application/json
type
enum<string>
requerido

Supported Meta channel type. Read get_channel_connection_options for human requirements.

Opciones disponibles:
instagram,
messenger,
whatsapp

Respuesta

Create temporary channel connection link

attemptId
string
requerido
tenantId
string
requerido
type
enum<string>
requerido
Opciones disponibles:
instagram,
messenger,
whatsapp
provider
enum<string>
requerido
Opciones disponibles:
meta
status
enum<string>
requerido
Opciones disponibles:
pending,
authorizing,
processing,
selecting,
completed,
partial,
failed,
expired
expiresAt
string<date-time>
requerido
channelIds
string[]
requerido
Maximum array length: 100
nextAction
string
requerido
failureCode
string
connectionUrl
string<uri>

Temporary browser link. Share with the intended business admin; do not log, index or expose to third parties.

failures
object[]

Saved failed provider resources and safe reason codes. Resolve ownership_conflict with the owning business; missing_messaging_task requires provider messaging permission; activation_failed requires WhatsApp activation checks; persistence failures require reconciliation before another attempt. Raw provider text is omitted.

Maximum array length: 100