Crea contatti in blocco

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

Importa fino a 10.000 contatti in una singola chiamata. I duplicati (per telefono o email) vengono uniti automaticamente ai contatti esistenti.

Se il limite di contatti del piano viene raggiunto durante l'import, la risposta ha codice HTTP 207 (parziale) e riporta quanti contatti sono stati effettivamente importati.

I custom_fields di ogni contatto seguono le regole di Crea contatto e vengono controllati tutti prima di importare: se anche un solo contatto ha un nome sconosciuto o un valore non valido, la risposta è 422 con custom_field_errors (per riga, es. contacts.3) e non viene importato niente.

Parametri

2 · 2 obbligatori

apikey obbligatorio

La tua API Key (anche header X-API-Key).

contacts obbligatorio

Array di oggetti contatto — max 10.000 per chiamata. Ogni oggetto accetta name, first_name, last_name, phone, email, tags, metadata, custom_fields.

Serve aiuto con l'integrazione? info@sendapp.live

Richiesta

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

Risposta

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