MB SuiteMB Suite
Menu

Referência da API · CRM

Registro de webhooks de entrada

crm · webhook_logs · 2 operações

GET/v1/crm/lead-sources/{source_id}/logsPOST/v1/crm/webhook-logs/{log_id}/retry
GET/v1/crm/lead-sources/{source_id}/logs

List the webhook deliveries of a lead source

crm.webhook_logs.list

LeituraIdempotenteDesde 2026-11-01

Lists what a lead source received through its webhook, newest first and paginated by cursor (limit up to 200): status (success, duplicate, error, rate_limited), the error, the stored payload, the lead created or matched (lead_id, with lead_kind: deal or prospect) and the person, and the retry state. Use it to find out why a lead did not arrive and which error entries can be retried with crm.webhook_logs.retry. Not found for deleted sources. Requires manage_sources (the entries carry the raw lead data). With Google Ads, LinkedIn or TikTok, their terms limit it through the API and the MCP: what they do not allow answers 403 platform_terms_restricted, and their fields are left out of the response (the permissions guide lists what each platform allows).

Escopo
crm:read
Permissão
Ver o módulo · Ação do CRM: manage_sources
Tool do MCP
crm_webhook_logs_listNa superfície completa; na compacta, mb_execute_operation com id: "crm.webhook_logs.list".

Custo declarado: até 603 leituras e 0 escritas por chamada (contam na cota diária).

Parâmetros

source_idstringrotaobrigatório

The lead source: an id of crm.lead_sources.list.

limitintegerqueryopcional

How many items this page brings at most (see the maximum and the default in the schema).

Padrão: 50

cursorstringqueryopcional

The next_cursor of the previous page, exactly as it came (only for the same list and filters); without it, the first page.

Resposta

dataarray<object>
has_moreboolean
next_cursorstring

Erros

lead_source_not_foundcrm_action_deniedinvalid_inputunknown_fieldauthentication_requiredscope_insufficientmodule_access_deniedoperation_not_foundrate_limitedquota_exceeded

Exemplo

curl "https://api.mb-suite.com/v1/crm/lead-sources/{source_id}/logs" \
  -H "Authorization: Bearer $MB_API_KEY"

Testar com a sua API key de teste

Com uma API key de teste o pedido vai sempre para a sua organização de prática: dados de exemplo que você pode reiniciar.

curl "https://api.mb-suite.com/v1/crm/lead-sources/{source_id}/logs" \
  -H "Authorization: Bearer $MB_TEST_KEY"
POST/v1/crm/webhook-logs/{log_id}/retry

Retry a failed webhook delivery

crm.webhook_logs.retry

EscritaDesde 2026-11-01

Re-processes a failed webhook delivery from its stored payload through the same ingestion as the original (person and company matched or created, prospect or deal, dedup, assignment, notifications, scoring and sequences). Only error entries of generic webhook and MB Suite form sources are retryable, an entry already retried successfully cannot be retried again, and its source must exist and be active. Meta, TikTok and Google deliveries are recovered with the backfill in the app instead. Requires manage_sources.

Escopo
crm:write
Permissão
Editar no módulo · Ação do CRM: manage_sources
Tool do MCP
crm_webhook_logs_retryNa superfície completa; na compacta, mb_execute_operation com id: "crm.webhook_logs.retry".
Eventos que pode emitir
crm.lead.createdcrm.deal.created

Custo declarado: até 22 leituras e 11 escritas por chamada (contam na cota diária).

Parâmetros

log_idstringrotaobrigatório

The error entry to re-process: an id of crm.webhook_logs.list with retryable true.

Resposta

duplicateboolean

Whether it matched a lead that already existed.

person_idstring
source_idstring
prospect_idstring

The prospect created or matched, when the source creates prospects.

deal_idstring

The deal created or matched, when the source creates deals.

Erros

webhook_log_not_foundcrm_action_deniedinvalid_inputunknown_fieldauthentication_requiredscope_insufficientidempotency_key_reusedrate_limitedquota_exceeded

Exemplo

curl -X POST "https://api.mb-suite.com/v1/crm/webhook-logs/{log_id}/retry" \
  -H "Authorization: Bearer $MB_API_KEY"

Testar com a sua API key de teste

Com uma API key de teste o pedido vai sempre para a sua organização de prática: dados de exemplo que você pode reiniciar.

curl -X POST "https://api.mb-suite.com/v1/crm/webhook-logs/{log_id}/retry" \
  -H "Authorization: Bearer $MB_TEST_KEY"