Create Contact
Create a single contact in your Bulkit account and optionally assign it to one group.
Last updated · Markdown version
HTTP method and path
HTTP
POST /api/v2/contactsAuthorization requirements
Authenticate using standard HTTP Bearer token:
HTTP
Authorization: Bearer bk_live_8n6JQv3K1h9Lp0Md
Content-Type: application/jsonFor backward compatibility, Bulkit also accepts apikey and apisecret in the JSON request body or X-API-Key / X-API-Secret headers.
Request example
cURL / Bash
curl -X POST "https://api.bulkitsms.com/api/v2/contacts" \
-H "Authorization: Bearer bk_live_8n6JQv3K1h9Lp0Md" \
-H "Content-Type: application/json" \
-d '{
"name": "John Doe",
"phone_number": "0700000000",
"email": "john@doe.com",
"group_ids": [14]
}'Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
name | Yes | string | Contact full name |
phone_number | Yes | string | Contact mobile number |
email | No | string | Contact email address |
group_ids | No | array of integers/UUIDs | Group IDs for assignment. Only one group is supported for now |
custom_metadata | No | object | Integration metadata payload accepted for compatibility |
Success response example
JSON
{
"status": "success",
"message": "Contact created successfully",
"data": {
"id": 442,
"first_name": "John",
"last_name": "Doe",
"mobile": "254700000000",
"email": "john@doe.com"
}
}Error response examples
JSON
{
"status": "error",
"message": "Invalid phone number"
}JSON
{
"status": "error",
"message": "Contact already exists"
}JSON
{
"status": "error",
"message": "Group not found"
}