Aggiungi tag

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

Aggiunge uno o più tag a un contatto mantenendo quelli esistenti. I tag già presenti vengono ignorati.

Parametri

3 · 3 obbligatori

apikey obbligatorio

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

id obbligatorio

ID del contatto (intero, nel path). Usa GET /api/contacts per trovarlo.

tags obbligatorio

Array o stringa di tag separati da virgole.

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

Richiesta

curl -X POST 'https://app.sendapp.ai/api/contacts/42/tags' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "tags": ["vip", "newsletter"] }'

<?php
$ch = curl_init('https://app.sendapp.ai/api/contacts/42/tags');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['X-API-Key: YOUR_API_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode(['tags' => ['vip', 'newsletter']]),
]);
echo curl_exec($ch);
curl_close($ch);

const res = await fetch('https://app.sendapp.ai/api/contacts/42/tags', {
  method: 'POST',
  headers: { 'X-API-Key': 'YOUR_API_KEY', 'Content-Type': 'application/json' },
  body: JSON.stringify({ tags: ['vip', 'newsletter'] })
});
console.log(await res.json());

Risposta

{
  "status": "success",
  "added": ["newsletter"],
  "tags": ["cliente", "vip", "newsletter"],
  "contact": { "id": 42, "...": "..." }
}

{
  "status": "error",
  "message": "The tags field is required (array or comma-separated string)."
}