Começando em 2 minutos
URL base
URL base
https://app.salos.com.br/apiAbrir a URL base no navegador (ou com curl, sem chave nenhuma) devolve o cartão de visita da
API — é a forma mais rápida de confirmar que você está batendo no endereço certo:
{
"produto": "Salos CRM — API",
"versao": "o endereço não carrega versão",
"documentacao": "https://developers.salos.com.br",
"recursos": ["/api/agenda", "/api/commissions/calculate", "/api/commissions/plans", "..."]
}A lista recursos traz, em ordem alfabética, os endereços de primeiro nível que respondem —
contatos, empresas, negócios, produtos, conversas, relatórios, webhooks e os demais.
Sua primeira chamada
# Guarde a chave numa variável — chave escrita direto no comando fica gravada
# no histórico do seu terminal.
export SALOS_API_KEY='cole-sua-chave-aqui'
curl "https://app.salos.com.br/api/contacts?limit=1" \
-H "Authorization: Bearer $SALOS_API_KEY"Resposta:
{
"data": [
{
"id": "9f1e4b7a-2d5c-4f8e-8b3a-6c9d2e5f1a73",
"name": "João Silva",
"email": "joao.silva@exemplo.com.br",
"phone": "+55 11 98888-0001",
"title": "Comprador",
"company_id": null,
"instagram": null,
"messenger_id": null,
"external_id": null,
"created_at": "2026-05-02T12:00:00.000Z",
"updated_at": "2026-05-02T12:00:00.000Z",
"custom_fields": {},
"tags": []
}
],
"pagination": { "next_cursor": null }
}Onde pegar a chave: no Salos, vá em Automações → API → Nova chave. Escolha as permissões e copie a chave — ela aparece uma única vez. Guardamos apenas um resumo criptografado dela; se você perder, não temos como recuperar, só criar outra.
Convenções
| Formato | JSON (UTF-8) na requisição e na resposta |
| Data e hora | ISO 8601 em UTC — 2026-07-02T12:00:00.000Z |
| Data pura | AAAA-MM-DD — 2026-08-15 |
| Identificadores | UUID |
| Resposta de lista | { "data": [...], "pagination": { "next_cursor": ... } } |
| Resposta de item | { "data": { ... } } |
| Exclusão bem-sucedida | 204 No Content, sem corpo |