API ReferenceWhatsApp
POST
bearerAuthheader
AuthorizationBearer <token>API key authentication. Pass your ioZen API key as a Bearer token in the Authorization header.
Phone, optional contact fields, approved template, and optional Intake Bot
application/json- body
phone*stringRecipient phone number. Normalized to E.164. Invalid numbers are rejected.
Length
1 <= length <= 32connection_id?stringWhatsApp connection to send from. Required when the workspace has more than one active connection.
Length
1 <= length <= 64contact?Contact fields to fill when empty. Existing values are left unchanged.
template*intake_bot_id?stringPublished Intake Bot that handles the reply. Omit to use the workspace routing rules.
Length
1 <= length <= 64Contact, conversation, and message ids
application/json- response
success*trueValue in
truedata*curl -X POST 'https://app.iozen.ai/api/v1/whatsapp/conversations' \ -H 'Content-Type: application/json' \ -d '{ "phone": "string", "template": { "name": "string", "language": "string" }}'Example Response
{ "success": true, "data": { "contact": { "id": "string", "created": true }, "conversation": { "id": "string", "created": true }, "message": { "id": "string", "status": "sending", "template": { "name": "string", "language": "string" } }, "idempotent": true }}