Começando em 2 minutos

Integre o Salos CRM: contatos, empresas, negócios, produtos, tarefas, leads, funis, conversas, agenda e webhooks.

URL base

https://app.salos.com.br/api

Abrir 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