curl --request POST \
--url https://app.useqx.com/api/v1/contacts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"tax_id": "12.345.678/0001-95",
"email": "fiscal@importadora.com.br",
"name": "Importadora Exemplo Ltda"
}
'{
"id": "com_12",
"type": "company",
"name": "Importadora Exemplo Ltda",
"trade_name": null,
"email": "fiscal@importadora.com.br",
"tax_id": "12345678000195",
"lookup_status": "pending",
"discarded": false,
"origin": "contact",
"created_at": "2026-09-25T10:30:00.000-03:00"
}Criar um contato
Cria uma pessoa pelo CPF ou uma empresa pelo CNPJ. O QX consulta o CPF ou o CNPJ depois da criação, e o lookup_status mostra o andamento da consulta. A criação conta no limite de escritas pagas da chave.
curl --request POST \
--url https://app.useqx.com/api/v1/contacts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"tax_id": "12.345.678/0001-95",
"email": "fiscal@importadora.com.br",
"name": "Importadora Exemplo Ltda"
}
'{
"id": "com_12",
"type": "company",
"name": "Importadora Exemplo Ltda",
"trade_name": null,
"email": "fiscal@importadora.com.br",
"tax_id": "12345678000195",
"lookup_status": "pending",
"discarded": false,
"origin": "contact",
"created_at": "2026-09-25T10:30:00.000-03:00"
}Authorizations
A chave de API da organização, no cabeçalho Authorization: Bearer <chave>. A chave começa com qx_.
Headers
Um valor único que o seu sistema cria para cada escrita, como um UUID. A chamada repetida com o mesmo valor e o mesmo conteúdo recebe a primeira resposta e não grava nada de novo. A API guarda a resposta por 24 horas.
1 - 255Body
O CPF da pessoa ou o CNPJ da empresa, com ou sem pontuação. O CNPJ pode ter letras nas doze primeiras posições. O valor decide o tipo do contato.
"12.345.678/0001-95"
O e-mail do contato.
"fiscal@importadora.com.br"
O nome do contato. Sem nome, o contato recebe o nome que a consulta do CPF ou do CNPJ traz.
"Importadora Exemplo Ltda"
Response
O contato criado.
O id do contato. O id da pessoa começa com per_, e o id da empresa começa com com_.
^(per|com)_[1-9][0-9]*$"com_12"
person para a pessoa e company para a empresa.
person, company O nome do contato. O valor é null até a consulta do CPF ou do CNPJ trazer o nome.
"Importadora Exemplo Ltda"
O nome fantasia da empresa. Na pessoa, o valor é null.
"Exemplo"
O e-mail do contato, em minúsculas.
"fiscal@importadora.com.br"
O CPF da pessoa ou o CNPJ da empresa, sem pontuação e com as letras em maiúscula. O valor é null na pessoa que espera a confirmação do CPF.
"12345678000195"
O andamento da consulta do CPF ou do CNPJ. not_enqueued: a consulta não começou. pending: a consulta está em curso. completed: a consulta terminou. failed: a consulta falhou. stale: os dados da consulta estão velhos. needs_review: a pessoa espera a confirmação do CPF.
not_enqueued, pending, completed, failed, stale, needs_review Com true, o contato está arquivado.
contact para o contato que a organização criou. shareholder para o sócio que a consulta do CNPJ criou.
contact, shareholder A data e a hora da criação, no fuso horário da organização.
"2026-09-25T10:30:00.000-03:00"