phone, a WhatsApp usernamewhatsapp_username), a Telegram user ID, or a Telegram username. Aphone value that parses as a WhatsApp username is stored as thename: required, max 50 characters.phone: optional; a WhatsApp phone (the WhatsAppRecipient rule).whatsapp_username: optional; with or without a leading @.telegram_user_id: optional integer. telegram_username: optionalgroup_ids: optional array of up to 50 group IDs to add the contact to.404 NOT_FOUND409 CONTACT_EXISTScontact_id.403 when reached).curl --location '/api/contacts/create' \
--header 'Content-Type: application/json' \
--data '{
"authkey": "{{authkey}}",
"name": "Retail Client",
"phone": "+966 50 123 4567"
}'{
"success": true,
"data": {
"contact_id": 7,
"name": "Retail Client",
"phone": "966501234567",
"whatsapp_username": null,
"whatsapp_id": null,
"telegram_user_id": null,
"telegram_username": null,
"groups": [],
"created_at": "2026-09-29T10:00:00+03:00"
}
}