Criar contato

Cria um novo contato no sistema. Campos customizados podem ser adicionados via custom_attributes.

POST /v1/contacts

Criar contato

cURL

curl --request POST \
  --url https://api.nuvia.ai/v1/contacts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "[e-mail]",
  "firstname": "<string>",
  "lastname": "<string>",
  "phone": "<string>",
  "company": "<string>",
  "properties": {}
}
'

201

{
  "name": "<string>",
  "country_code": "<string>",
  "phone_number": "<string>",
  "company": "<unknown>",
  "_id": "<string>",
  "email": "<string>",
  "last_activity_at": "<unknown>",
  "linkedin_identifier": "<string>",
  "job_title": "<string>",
  "seniority": "<string>",
  "department": "<string>",
  "country": "<string>",
  "region": "<string>",
  "city": "<string>",
  "experience": "<string>",
  "skills": "<string>",
  "additional_attributes": "<unknown>",
  "createdAt": "<unknown>",
  "updatedAt": "<unknown>"
}

Authorizations

Authorization · string · header · required

Token JWT de autenticação

Headers

x-company-id · string

Identificador da empresa-alvo. Obrigatório apenas para API Keys globais (type=global). Ignorado para API Keys de empresa e usuários humanos.

Body

application/json

email · string<email>

Pattern: ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$

firstname · string

lastname · string

phone · string

company · string

properties · object

Show child attributes

Response

201

application/json

Contato criado com sucesso

name · string · required

Nome do contato

country_code · string · required

Código do país do número de telefone

phone_number · string · required

Número de telefone do contato

company · any · required

Empresa do contato

_id · string

ID do contato

email · string

E-mail do contato

last_activity_at · any

Data da última atividade do contato

linkedin_identifier · string

Identificador do perfil do LinkedIn

job_title · string

Cargo do contato

seniority · string

Nível de senioridade do contato

department · string

Departamento do contato

country · string

País do contato

region · string

Estado ou região do contato

city · string

Cidade do contato

experience · string

Experiência profissional do contato

skills · string

Habilidades do contato

additional_attributes · any

Atributos adicionais do contato

createdAt · any

Data de criação do contato

updatedAt · any

Data de atualização do contato