Kontakt abrufen

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

Liefert einen einzelnen Kontakt mit allem, was dazugehört: Tags, benutzerdefinierte Felder (nach Name), Abmeldestatus, zuständige Person, Lebenszyklusphase und Interaktionszähler.

Parameter

2 · 2 Pflichtfelder

apikey erforderlich

Ihr API Key (der Header X-API-Key funktioniert ebenfalls).

id erforderlich

Kontakt-ID (Ganzzahl, im Pfad). Verwenden Sie GET /api/contacts, um sie zu finden.

Brauchen Sie Hilfe bei der Integration? info@sendapp.live

Anfrage

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

Antwort

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