Send one WhatsApp conversion
POST/v1/communication/channel/whatsapp/:applicationChannelId/conversions
Send one conversion via the connected Cloud API channel. The server resolves app credentials, WABA and dataset handling. The body requires ctwa_clid, currency and value; optional event_name is a nonblank string (default Purchase), and optional event_time is an integer Unix timestamp in seconds (default first admission time). Supplied fields are forwarded to the provider, whose event/time validation still applies. Null and empty values are invalid. Header Idempotency-Key identifies a purchase within this channel across REST and MCP. Same key/body replays the accepted receipt; same key/different body conflicts. The click ID must be genuine and belong to this channel context; a locally unknown ID is allowed and cannot be verified by Hub. Received by the provider does not guarantee ad attribution, revenue or CRM status changes. No automatic POST retry. Timeout/5xx/ambiguous response is DELIVERY_UNKNOWN: retain the same key and reconcile, never create a new key to force resending. Receipts are durable. Up to 500 provider requests/minute conservatively shared by the integration; replay consumes no quota.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 409
- 429
- 502
- 503
Provider accepted one event, or replay of its stored receipt.
Response Headers
no-store
WHATSAPP_CONVERSION_INVALID_INPUT.
Authentication required.
Insufficient permission.
Channel not found or outside application scope.
WHATSAPP_CONVERSION_IDEMPOTENCY_CONFLICT, IN_PROGRESS, DELIVERY_UNKNOWN, TARGET_CHANGED, WABA_REQUIRED or UNSUPPORTED_CHANNEL. Unknown delivery must not be resent with a new key.
WHATSAPP_CONVERSION_RATE_LIMITED; retry the same key after the delay.
Response Headers
Seconds until manual retry.
WHATSAPP_CONVERSION_PROVIDER_ACCESS or PROVIDER_REJECTED.
WHATSAPP_CONVERSION_UNAVAILABLE; no dispatch when coordination fails.