Criar Contato

POST /external/v1/contacts

Cria um novo contato na sua conta.

Autenticacao

Requer permissao contacts:write.

Corpo da Requisicao

Campo	Tipo	Obrigatorio	Descricao
name	string	Sim	Nome completo do contato
email	string	Nao	Endereco de e-mail
phone	string	Nao	Numero de telefone com codigo do pais
company	string	Nao	Nome da empresa
position	string	Nao	Cargo/posicao
linkedin_url	string	Nao	URL do perfil no LinkedIn
source	string	Nao	Origem do lead (padrao: "other")
tags	array	Nao	Array de strings de tags
custom_fields	object	Nao	Pares chave-valor de campos personalizados

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",
    "position": "CTO",
    "tags": ["hot-lead", "tech"]
  }'

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',
    position: 'CTO',
    tags: ['hot-lead', 'tech']
  },
  {
    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',
        'position': 'CTO',
        'tags': ['hot-lead', 'tech']
    }
)

print(response.json())

Resposta

{
  "success": true,
  "data": {
    "id": "cnt_xyz789abc123",
    "name": "Jane Smith",
    "email": "jane@company.com",
    "phone": "+5511988888888",
    "company": "Tech Corp",
    "position": "CTO",
    "source": "other",
    "tags": ["hot-lead", "tech"],
    "custom_fields": {},
    "created_at": "2024-01-25T09:00:00Z",
    "updated_at": "2024-01-25T09:00:00Z"
  }
}

Erros

Status	Codigo	Descricao
400	VALIDATION_ERROR	Campos obrigatorios ausentes ou invalidos
400	INVALID_EMAIL	Formato de e-mail invalido
409	ALREADY_EXISTS	Contato com este e-mail ja existe