Bulk create contacts

POST https://app.sendapp.ai/api/contacts/bulk

Import up to 10,000 contacts in a single call. Duplicates (by phone or email) are automatically merged with existing contacts.

If the plan's contact limit is reached during import, the response has HTTP code 207 (partial) and reports how many contacts were actually imported.

The custom_fields of each contact follow the rules of Create contact and are all checked before importing: if even one contact has an unknown name or an invalid value, the response is 422 with custom_field_errors (per row, e.g. contacts.3) and nothing is imported.

Parameters

2 · 2 required

apikey required

Your API Key (the X-API-Key header also works).

contacts required

Array of contact objects — max 10,000 per call. Each object accepts name, first_name, last_name, phone, email, tags, metadata, custom_fields.

Need help with the integration? info@sendapp.live

Request

curl -X POST 'https://app.sendapp.ai/api/contacts/bulk' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "contacts": [
      { "name": "Alice", "phone": "+39111111111", "tags": ["newsletter"] },
      { "name": "Bob", "email": "bob@example.com" }
    ]
  }'

<?php
$ch = curl_init('https://app.sendapp.ai/api/contacts/bulk');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['X-API-Key: YOUR_API_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode([
        'contacts' => [
            ['name' => 'Alice', 'phone' => '+39111111111', 'tags' => ['newsletter']],
            ['name' => 'Bob', 'email' => 'bob@example.com'],
        ],
    ]),
]);
echo curl_exec($ch);
curl_close($ch);

const res = await fetch('https://app.sendapp.ai/api/contacts/bulk', {
  method: 'POST',
  headers: { 'X-API-Key': 'YOUR_API_KEY', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    contacts: [
      { name: 'Alice', phone: '+39111111111', tags: ['newsletter'] },
      { name: 'Bob', email: 'bob@example.com' }
    ]
  })
});
console.log(await res.json());

Response

{
  "status": "success",
  "results": {
    "total": 3,
    "imported": 2,
    "updated": 1,
    "unchanged": 0,
    "errors": [],
    "discarded": [],
    "limit_exceeded": false,
    "custom_fields_created": 0
  },
  "limit_info": {
    "exceeded": false,
    "current": 130,
    "max": 5000,
    "unlimited": false
  }
}

{
  "status": "error",
  "message": "Error importing contacts."
}