Criar empresa

POST/api/v1/accounts

Cria uma empresa. Nomes duplicados são permitidos (filiais).

Body (JSON)

`name`obrigatório string	Nome (1-160 caracteres).
`website` string \| null	Website (max 300 caracteres).
`industry` string \| null	Setor (max 120 caracteres).
`size` string \| null	Porte, texto livre (max 60 caracteres). Ex.: "11-50".
`customFields` object	Objeto `{ chave: valor }` com as `key`s de custom fields de ACCOUNT (`GET /custom-fields?entity=ACCOUNT`).

Headers

Idempotency-Key

string

Opcional, recomendado (8-200 caracteres, ex.: um UUID). A primeira request é processada normalmente; requests com a mesma key e mesmo body em até 24h retornam a resposta cacheada (header Idempotency-Replay: true), sem criar duplicata. Mesma key com body diferente retorna 422 IDEMPOTENCY_CONFLICT. Só respostas 2xx são cacheadas.

Resposta 201 Created.

Suporta Idempotency-Key · replays com mesmo body em até 24h retornam a resposta cacheada sem duplicar (útil pra retries de n8n/Zapier).

Dispara webhook account.created.

Autenticação: header Authorization: Bearer rmk_... · veja Introdução e autenticação.

curl -X POST "https://crmdojordao.com.br/api/v1/accounts" \
  -H "Authorization: Bearer rmk_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Empresa Exemplo LTDA", "website": "empresaexemplo.com.br", "industry": "SaaS", "size": "11-50", "customFields": {} }'

Request body

{
  "name": "Empresa Exemplo LTDA",
  "website": "empresaexemplo.com.br",
  "industry": "SaaS",
  "size": "11-50",
  "customFields": {}
}

Resposta · POST /api/v1/accounts

{
  "id": "acc_empresa_exemplo",
  "name": "Empresa Exemplo LTDA",
  "website": "empresaexemplo.com.br",
  "industry": "SaaS",
  "size": "11-50",
  "ownerId": null,
  "customFields": {},
  "createdAt": "2026-07-01T13:30:00.000Z",
  "updatedAt": "2026-07-01T13:30:00.000Z"
}