Créer un contact

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

Crée (ou met à jour via upsert) un seul contact. Il doit avoir au moins un téléphone OU un e-mail. Les contacts existants avec le même téléphone/e-mail sont fusionnés (tags combinés, métadonnées fusionnées).

Réponses : 201 Created avec le contact créé — 403 si la limite de contacts du plan est atteinte — 422 si le téléphone et l'e-mail sont tous deux absents.

Paramètres

6 · 3 obligatoires

apikey obligatoire

Votre API Key (l'en-tête X-API-Key fonctionne aussi).

name facultatif

Nom complet, jusqu'à 255 caractères.

phone obligatoire

Format international (ex. +393391234567). Obligatoire si l'e-mail est absent.

email obligatoire

E-mail valide. Obligatoire si le téléphone est absent.

tags facultatif

Tableau de chaînes ou chaîne séparée par des virgules (ex. "vip,newsletter").

metadata facultatif

Objet JSON avec des champs personnalisés.

Besoin d'aide pour l'intégration ? info@sendapp.live

Requête

curl -X POST 'https://app.sendapp.ai/api/contacts' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Mario Rossi",
    "phone": "+393391234567",
    "email": "mario@example.com",
    "tags": ["newsletter", "vip"],
    "metadata": { "source": "landing_page_a" }
  }'

<?php
$ch = curl_init('https://app.sendapp.ai/api/contacts');
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([
        'name'     => 'Mario Rossi',
        'phone'    => '+393391234567',
        'email'    => 'mario@example.com',
        'tags'     => ['newsletter', 'vip'],
        'metadata' => ['source' => 'landing_page_a'],
    ]),
]);
echo curl_exec($ch);
curl_close($ch);

const res = await fetch('https://app.sendapp.ai/api/contacts', {
  method: 'POST',
  headers: { 'X-API-Key': 'YOUR_API_KEY', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    name: 'Mario Rossi',
    phone: '+393391234567',
    email: 'mario@example.com',
    tags: ['newsletter', 'vip'],
    metadata: { source: 'landing_page_a' }
  })
});
console.log(await res.json());

Réponse

{
  "status": "success",
  "contact": {
    "id": 4022,
    "name": "Giulia Bianchi",
    "phone": "393334455667",
    "email": "giulia.bianchi@example.com",
    "tags": [
      "lead"
    ],
    "metadata": [],
    "created_at": "2026-07-13 10:00:00",
    "updated_at": "2026-07-13 10:00:00"
  }
}

{
  "status": "error",
  "message": "Contact limit reached. Please upgrade your plan."
}