Crear contactos en bloque

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

Importa hasta 10.000 contactos en una sola llamada. Los duplicados (por teléfono o email) se fusionan automáticamente con los contactos existentes.

Si se alcanza el límite de contactos del plan durante la importación, la respuesta tiene código HTTP 207 (parcial) e indica cuántos contactos se importaron realmente.

Los custom_fields de cada contacto siguen las reglas de Crear contacto y se comprueban todos antes de importar: si aunque sea un solo contacto tiene un nombre desconocido o un valor no válido, la respuesta es 422 con custom_field_errors (por fila, p. ej. contacts.3) y no se importa nada.

Parámetros

2 · 2 obligatorios

apikey obligatorio

Tu API Key (también sirve la cabecera X-API-Key).

contacts obligatorio

Array de objetos contacto — máx. 10.000 por llamada. Cada objeto acepta name, first_name, last_name, phone, email, tags, metadata, custom_fields.

¿Necesitas ayuda con la integración? info@sendapp.live

Solicitud

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());

Respuesta

{
  "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."
}