Criar Contato

POST /external/v1/contacts

Cria um novo contato na sua conta.

Retry seguro

Envie um header Idempotency-Key para tornar retries seguros — uma requisicao repetida com a mesma chave repete a resposta original em vez de criar um duplicado.

Autenticacao

Requer permissao contacts:write.

Corpo da Requisicao

Campo	Tipo	Obrigatorio	Descricao
name	string	Sim	Nome completo do contato
email	string	Nao	E-mail
phone	string	Nao	Telefone com codigo do pais
company	string	Nao	Empresa
title	string	Nao	Cargo/posicao
location	string	Nao	Localizacao
linkedin_profile_url	string	Nao	URL do perfil no LinkedIn
source	string	Nao	Origem do lead (padrao: api)
tags	array	Nao	Array de IDs de tag (UUIDs) a vincular
custom_fields	object	Nao	Pares chave-valor de campos customizados

Requisicao

cURL

curl --request POST \
  --url "https://app.getraze.com/external/v1/contacts" \
  --header "Content-Type: application/json" \
  --header "X-API-Key: YOUR_API_KEY" \
  --data '{
    "name": "Jane Smith",
    "email": "jane@company.com",
    "phone": "+5511988888888",
    "company": "Tech Corp",
    "title": "CTO",
    "tags": ["tag_01", "tag_02"]
  }'

Node.js

const axios = require('axios');

const response = await axios.post(
  'https://app.getraze.com/external/v1/contacts',
  {
    name: 'Jane Smith',
    email: 'jane@company.com',
    phone: '+5511988888888',
    company: 'Tech Corp',
    title: 'CTO',
    tags: ['tag_01', 'tag_02']
  },
  {
    headers: {
      'X-API-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    }
  }
);

console.log(response.data);

Python

import requests

response = requests.post(
    'https://app.getraze.com/external/v1/contacts',
    headers={
        'X-API-Key': 'YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'name': 'Jane Smith',
        'email': 'jane@company.com',
        'phone': '+5511988888888',
        'company': 'Tech Corp',
        'title': 'CTO',
        'tags': ['tag_01', 'tag_02']
    }
)

print(response.json())

Resposta

{
  "success": true,
  "data": {
    "id": "cnt_xyz789abc123",
    "name": "Jane Smith",
    "email": "jane@company.com",
    "phone": "+5511988888888",
    "company": "Tech Corp",
    "title": "CTO",
    "location": null,
    "linkedin_profile_url": null,
    "source": "api",
    "custom_fields": null,
    "created_at": "2026-01-25T09:00:00Z",
    "updated_at": "2026-01-25T09:00:00Z",
    "tags": [
      { "id": "tag_01", "name": "hot-lead", "color": "red" }
    ]
  }
}

A resposta retorna o registro completo do contato junto com os objetos tags resolvidos.

Erros

Status	Codigo	Descricao
400	VALIDATION_ERROR	name ausente ou vazio
409	DUPLICATE_ERROR	Ja existe um contato com este e-mail