Autenticação
Bearer token no formato hs_live_*, gerado nas configurações do workspace.
Developers
API pública e webhooks para operações comerciais.
Conecte o Hub Sellfy a n8n, Make, ERPs, BI ou sistemas internos usando API REST, Bearer tokens e webhooks assinados.
Limite
60 requisições por minuto por API key, com headers de rate limit.
Plano
Disponível no Growth e Enterprise, junto com webhooks outbound.
Endpoints v1
| Método | Rota | Uso |
|---|---|---|
| GET | /api/v1/leads | Lista leads do workspace associado à API key. |
| POST | /api/v1/leads | Cria lead com deduplicação por e-mail ou telefone. |
| GET | /api/v1/leads/{id} | Retorna detalhes de um lead. |
| PATCH | /api/v1/leads/{id} | Atualiza dados de um lead. |
| GET | /api/v1/deals | Lista negócios do workspace. |
| POST | /api/v1/deals | Cria um negócio vinculado opcionalmente a um lead. |
Webhooks outbound
O Hub Sellfy pode enviar eventos para URLs configuradas pelo workspace. Cada entrega usa assinatura HMAC-SHA256 para validação no destino e retry controlado.
Boas práticas
- Armazene API keys como segredo server-side.
- Valide assinatura de webhook antes de processar eventos.
- Use idempotência ao receber eventos repetidos.
- Leia o OpenAPI JSON antes de automatizar integrações críticas.