Atualizar Contato

PUT /external/v1/contacts/:id

Atualiza um contato existente. Apenas os campos fornecidos serao atualizados.

Autenticacao

Requer permissao contacts:write.

Parametros de Caminho

Parametro	Tipo	Obrigatorio	Descricao
id	string	Sim	O identificador unico do contato

Corpo da Requisicao

Todos os campos sao opcionais. Inclua apenas os campos que deseja atualizar.

Campo	Tipo	Descricao
name	string	Nome completo do contato
email	string	Endereco de e-mail
phone	string	Numero de telefone
company	string	Nome da empresa
position	string	Cargo/posicao
linkedin_url	string	URL do perfil no LinkedIn
tags	array	Array de strings de tags (substitui as tags existentes)
custom_fields	object	Pares chave-valor de campos personalizados

Requisicao

cURL

curl --request PUT \
  --url "https://app.getraze.com/external/v1/contacts/cnt_abc123def456" \
  --header "Content-Type: application/json" \
  --header "X-API-Key: YOUR_API_KEY" \
  --data '{
    "position": "VP of Engineering",
    "tags": ["hot-lead", "enterprise"]
  }'

Node.js

const axios = require('axios');

const contactId = 'cnt_abc123def456';

const response = await axios.put(
  `https://app.getraze.com/external/v1/contacts/${contactId}`,
  {
    position: 'VP of Engineering',
    tags: ['hot-lead', 'enterprise']
  },
  {
    headers: {
      'X-API-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    }
  }
);

console.log(response.data);

Python

import requests

contact_id = 'cnt_abc123def456'

response = requests.put(
    f'https://app.getraze.com/external/v1/contacts/{contact_id}',
    headers={
        'X-API-Key': 'YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'position': 'VP of Engineering',
        'tags': ['hot-lead', 'enterprise']
    }
)

print(response.json())

Resposta

{
  "success": true,
  "data": {
    "id": "cnt_abc123def456",
    "name": "John Doe",
    "email": "john@example.com",
    "phone": "+5511999999999",
    "company": "Acme Inc",
    "position": "VP of Engineering",
    "source": "linkedin",
    "linkedin_url": "https://linkedin.com/in/johndoe",
    "tags": ["hot-lead", "enterprise"],
    "custom_fields": {},
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-01-25T10:00:00Z"
  }
}

Erros

Status	Codigo	Descricao
400	VALIDATION_ERROR	Valores de campos invalidos
404	NOT_FOUND	Contato nao encontrado