ChatofyDevelopers
REST APIMCP Server (AI)New
API KeysWebhooks
Chatofy API
/
Getting Started
API Resources
API v1.0 Live
Developer APIContactsBulk Create Contacts

Bulk Create Contacts

Creates up to 500 contacts in batch with per-item status resilience. Idempotent via Idempotency-Key header.

POST/api/v1/contacts/bulk

Request Body Schema

application/json
contactsarray<object>required

Array of up to 500 contact objects

Response Payload

200 OKapplication/json
statusstring

"1" = Success, "0" = Failure.

messageobject

The response data payload.

Code Snippets & Examples

1curl -X POST "https://app.chatofy.in/api/v1/contacts/bulk" \
2 -H "Authorization: Bearer YOUR_API_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{"contacts":[{"phone_number":"+919876543210","first_name":"Aarav"}]}'

Was this endpoint guide helpful?

Previous Endpoint
Upsert Contact by Phone
Next Endpoint
List Duplicate Contacts
© 2026 Chatofy Cloud Platform. All rights reserved.
1curl -X POST "https://app.chatofy.in/api/v1/contacts/bulk" \
2 -H "Authorization: Bearer YOUR_API_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{"contacts":[{"phone_number":"+919876543210","first_name":"Aarav"}]}'
200 OKapplication/json
1{
2 "success": true,
3 "data": {
4 "summary": {
5 "total": 1,
6 "succeeded": 1,
7 "failed": 0
8 },
9 "results": [
10 {
11 "index": 0,
12 "success": true,
13 "data": {
14 "id": "c1111111-2222-3333-4444-555555555555",
15 "phone_number": "919876543210",
16 "first_name": "Aarav",
17 "created_at": "2026-10-26T22:00:00+05:30"
18 }
19 }
20 ]
21 },
22 "message": "Batch contacts processed"
23}