Aggiorna contatto

PUThttps://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.

Parameters

apikey required

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

id required

Contact ID (integer, in the path). Use GET /api/contacts to find it.

name optional

Nome del contatto.

phone optional

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

email optional

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

birthday optional

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

tags optional

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

custom_fields optional

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

opted_out optional

true = escludi dalle campagne, false = riattiva.

lifecycle_stage optional

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

Request

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

Response (200 OK)

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

Error

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