Atualizar contacto

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

Atualiza um ou mais campos de um contacto. Só as chaves enviadas são alteradas; tags SUBSTITUI o conjunto completo (use os endpoints de etiquetas para acrescentar ou remover etiquetas individuais). Cada alteração fica registada no histórico do contacto. Também aceita PATCH.

Parâmetros

10 · 2 obrigatórios

apikey obrigatório

A sua API Key (o cabeçalho X-API-Key também funciona).

id obrigatório

ID do contacto (inteiro, no path). Use GET /api/contacts para o encontrar.

name opcional

Nome do contacto.

phone opcional

Telefone em formato internacional. 409 se já pertencer a outro contacto.

email opcional

Endereço de email. 409 se já pertencer a outro contacto.

birthday opcional

Data no formato YYYY-MM-DD (null para apagar).

tags opcional

Array ou texto separado por vírgulas — substitui todas as etiquetas.

custom_fields opcional

Objeto cuja chave é o NOME do campo personalizado, p. ex. {"Cidade": "Lisboa"}. Nomes desconhecidos devolvem 422. Envie null ou "" para esvaziar um valor.

opted_out opcional

true = excluir das campanhas, false = reativar.

lifecycle_stage opcional

Um de lead, qualified, customer, inactive, lost (null para apagar).

Precisa de ajuda com a integração? info@sendapp.live

Pedido

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

Resposta

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