Skip to main content

Endpoint

POST /v1/companies
Escopo necessário: write:companies

Corpo da requisição

CampoTipoObrigatórioDescrição
namestringSimNome da empresa
emailstringNãoEmail
phonestringNãoTelefone
websitestringNãoURL do site
sectorstringNãoSetor de atuação
sizestringNãoTamanho: 1-10, 11-50, 51-200, 201-500, 500+
citystringNãoCidade
statestringNãoEstado (sigla, ex: SP)
assigned_tostringNãoID do membro responsável
tagsstring[]NãoTags
custom_fieldsobjectNãoCampos personalizados

Exemplo de requisição

curl -X POST https://api.socialsell.ai/v1/companies \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Nova Empresa Ltda",
    "email": "contato@novaempresa.com.br",
    "phone": "+5511222233334",
    "sector": "Varejo",
    "size": "11-50",
    "city": "Curitiba",
    "state": "PR",
    "tags": ["prospect"]
  }'

Resposta

Retorna HTTP 201 com o objeto empresa criado.

Erros

CódigoStatusDescrição
MISSING_REQUIRED_FIELD400Campo name ausente
DUPLICATE409Empresa duplicada