Skip to main content

Negócios (Deals)

O recurso deals permite gerenciar os negócios no pipeline de vendas.

Listar negócios

curl "https://api.synax.app.br/functions/v1/api-proxy/deals?order=created_at.desc&limit=20" \
  -H "Authorization: Bearer sk_live_SuaChaveAqui"

Filtros

ParâmetroExemploDescrição
status=openPor statusopen, won, lost

Criar negócio

Requer chave com permissão de escrita.
curl -X POST "https://api.synax.app.br/functions/v1/api-proxy/deals" \
  -H "Authorization: Bearer sk_live_SuaChaveAqui" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Proposta Growth - João Silva",
    "value": 15000,
    "contact_id": "{contact_id}",
    "stage_id": "{stage_id}"
  }'

Mover para outro estágio

curl -X PATCH "https://api.synax.app.br/functions/v1/api-proxy/deals/{id}" \
  -H "Authorization: Bearer sk_live_SuaChaveAqui" \
  -H "Content-Type: application/json" \
  -d '{
    "stage_id": "{new_stage_id}"
  }'

Marcar como ganho/perdido

curl -X PATCH "https://api.synax.app.br/functions/v1/api-proxy/deals/{id}" \
  -H "Authorization: Bearer sk_live_SuaChaveAqui" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "won"
  }'

Listar pipelines e estágios

# Pipelines
curl "https://api.synax.app.br/functions/v1/api-proxy/pipelines" \
  -H "Authorization: Bearer sk_live_SuaChaveAqui"

# Estágios de um pipeline
curl "https://api.synax.app.br/functions/v1/api-proxy/stages?order=position.asc" \
  -H "Authorization: Bearer sk_live_SuaChaveAqui"