Criar contactos em massa

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

Importe até 10.000 contactos numa única chamada. Os duplicados (por telefone ou email) são automaticamente unidos aos contactos existentes.

Se o limite de contactos do plano for atingido durante a importação, a resposta tem o código HTTP 207 (parcial) e indica quantos contactos foram efetivamente importados.

Os custom_fields de cada contacto seguem as regras de Criar contacto e são todos verificados antes da importação: se mesmo um só contacto tiver um nome desconhecido ou um valor inválido, a resposta é 422 com custom_field_errors (por linha, p. ex. contacts.3) e nada é importado.

Parâmetros

2 · 2 obrigatórios

apikey obrigatório

A sua API Key (o cabeçalho X-API-Key também funciona).

contacts obrigatório

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

Precisa de ajuda com a integração? info@sendapp.live

Pedido

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

Resposta

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