Lire un contact

GET https://app.sendapp.ai/api/contacts/{id}

Renvoie un contact avec tout ce qui lui est associé : tags, champs personnalisés (par nom), statut de désinscription, responsable, étape du cycle de vie et compteurs d'interaction.

Paramètres

2 · 2 obligatoires

apikey obligatoire

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

id obligatoire

ID du contact (entier, dans le chemin). Utilisez GET /api/contacts pour le trouver.

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

Requête

curl 'https://app.sendapp.ai/api/contacts/42' \
  -H 'X-API-Key: YOUR_API_KEY'

<?php
$ch = curl_init('https://app.sendapp.ai/api/contacts/42');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => ['X-API-Key: YOUR_API_KEY'],
]);
echo curl_exec($ch);
curl_close($ch);

const res = await fetch('https://app.sendapp.ai/api/contacts/42', {
  method: 'GET',
  headers: { 'X-API-Key': 'YOUR_API_KEY' }
});
console.log(await res.json());

Réponse

{
  "status": "success",
  "contact": {
    "id": 42,
    "name": "Mario Rossi",
    "phone": "+393331234567",
    "email": "mario@example.com",
    "birthday": "1985-04-12",
    "tags": ["cliente", "vip"],
    "custom_fields": { "City": "Milano", "Buy status": "active" },
    "metadata": { "source": "api" },
    "opted_out": false,
    "opted_out_at": null,
    "opted_out_reason": null,
    "owner": { "id": 3, "name": "Giulia" },
    "lifecycle_stage": "customer",
    "engagement": {
      "last_interaction_at": 1757260800,
      "last_inbound_at": 1757260800,
      "last_outbound_at": 1757174400,
      "conversations_count": 2,
      "primary_channel": "whatsapp"
    },
    "created_at": 1752400000,
    "updated_at": 1757260800
  }
}

{
  "status": "error",
  "message": "Contact not found."
}