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	Identificador unico do contato

Corpo da Requisicao

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

Campo	Tipo	Descricao
name	string	Nome completo do contato
email	string	E-mail
phone	string	Telefone
company	string	Empresa
title	string	Cargo/posicao
location	string	Localizacao
linkedin_profile_url	string	URL do perfil no LinkedIn
tags	array	Array de IDs de tag (UUIDs) — substitui as tags existentes
custom_fields	object	Pares chave-valor de campos customizados

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 '{
    "title": "VP de Engenharia",
    "tags": ["tag_01", "tag_03"]
  }'

Node.js

const axios = require('axios');

const contactId = 'cnt_abc123def456';

const response = await axios.put(
  `https://app.getraze.com/external/v1/contacts/${contactId}`,
  {
    title: 'VP de Engenharia',
    tags: ['tag_01', 'tag_03']
  },
  {
    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={
        'title': 'VP de Engenharia',
        'tags': ['tag_01', 'tag_03']
    }
)

print(response.json())

Resposta

{
  "success": true,
  "data": {
    "id": "cnt_abc123def456",
    "name": "John Doe",
    "email": "john@example.com",
    "phone": "+5511999999999",
    "company": "Acme Inc",
    "title": "VP de Engenharia",
    "location": "Sao Paulo, BR",
    "linkedin_profile_url": "https://linkedin.com/in/johndoe",
    "source": "LinkedIn",
    "custom_fields": {},
    "created_at": "2026-01-15T10:30:00Z",
    "updated_at": "2026-01-25T10:00:00Z",
    "tags": [
      { "id": "tag_01", "name": "hot-lead", "color": "red" },
      { "id": "tag_03", "name": "enterprise", "color": "purple" }
    ]
  }
}

Erros

Status	Codigo	Descricao
404	NOT_FOUND	Contato nao encontrado