Aggiorna contatto

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

Aggiorna uno o più campi di un contatto. Vengono modificate solo le chiavi inviate; tags SOSTITUISCE l'intero set (usa gli endpoint dei tag per aggiungerne o rimuoverne singoli). Ogni modifica viene registrata nella cronologia del contatto. Accetta anche PATCH.

Parametri

10 · 2 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.

name opzionale

Nome del contatto.

phone opzionale

Telefono in formato internazionale. 409 se appartiene già a un altro contatto.

email opzionale

Indirizzo email. 409 se appartiene già a un altro contatto.

birthday opzionale

Data nel formato YYYY-MM-DD (null per cancellare).

tags opzionale

Array o stringa separata da virgole — sostituisce tutti i tag.

custom_fields opzionale

Oggetto con chiave = NOME del campo personalizzato, es. {"Città": "Roma"}. Nomi sconosciuti restituiscono 422. Invia null o "" per svuotare un valore.

opted_out opzionale

true = escludi dalle campagne, false = riattiva.

lifecycle_stage opzionale

Uno tra lead, qualified, customer, inactive, lost (null per cancellare).

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

Richiesta

curl -X PUT 'https://app.sendapp.ai/api/contacts/42' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "name": "Mario Rossi", "tags": ["cliente", "vip"], "custom_fields": { "City": "Milano" }, "lifecycle_stage": "customer" }'

<?php
$ch = curl_init('https://app.sendapp.ai/api/contacts/42');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'PUT',
    CURLOPT_HTTPHEADER => ['X-API-Key: YOUR_API_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode(['name' => 'Mario Rossi', 'tags' => ['cliente', 'vip'], 'custom_fields' => ['City' => 'Milano'], 'lifecycle_stage' => 'customer']),
]);
echo curl_exec($ch);
curl_close($ch);

const res = await fetch('https://app.sendapp.ai/api/contacts/42', {
  method: 'PUT',
  headers: { 'X-API-Key': 'YOUR_API_KEY', 'Content-Type': 'application/json' },
  body: JSON.stringify({ name: 'Mario Rossi', tags: ['cliente', 'vip'], custom_fields: { City: 'Milano' }, lifecycle_stage: 'customer' })
});
console.log(await res.json());

Risposta

{
  "status": "success",
  "changed": ["name", "tags", "custom_fields", "lifecycle_stage"],
  "contact": { "id": 42, "name": "Mario Rossi", "tags": ["cliente", "vip"], "lifecycle_stage": "customer", "...": "..." }
}

{
  "status": "error",
  "message": "Unknown custom field(s): Citta",
  "unknown_fields": ["Citta"]
}