Menú

Referencia de la API · Phones

Llamadas

crm_phones · calls · 3 operaciones

GET/v1/crm/calls

List phone calls

crm.calls.list

LecturaIdempotenteDesde 2026-11-01

Lists the calls made and received with the org's phone lines, newest first, paginated by cursor (limit up to 200, default 25): direction, status, from/to and the other party's number (a call from the app's dialer comes from its line's number), the owner and who answered with their names, when it started, was answered and ended, duration, voicemail, whether it was recorded, the linked person, deal, company or prospect, the seller's notes and disposition, and the CRM activity it created. Filter by one of line_id, owner_id, deal_id or direction, plus a since/until range on the creation time. Recordings and costs are not included. Module: Phones (crm_phones), even though the id starts with crm.; the credential needs the crm_phones:read scope.

Alcance
crm_phones:read
Permiso
Ver el módulo
Tool del MCP
crm_calls_listEn la superficie completa; en la compacta, mb_execute_operation con id: "crm.calls.list".

Costo declarado: hasta 202 lecturas y 0 escrituras por llamada (cuentan en el cupo diario).

Parámetros

limitintegerqueryopcional

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

Por defecto: 25

cursorstringqueryopcional

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

line_idstringqueryopcional

Only the calls of this phone line: an id from crm_phones.lines.list.

owner_idstringqueryopcional

Only the calls of this member (the seller who made or took them): a user_id from crm.team.list.

deal_idstringqueryopcional

Only the calls linked to this deal (crm.deals.list).

directionenumqueryopcional

inbound, outbound-api (from an automation or the voice agent) or outbound-dial (from the app's dialer).

Valores: inbound, outbound-api, outbound-dial

sinceintegerqueryopcional

Only the calls created from this time on (epoch ms, inclusive).

untilintegerqueryopcional

Only the calls created up to this time (epoch ms, inclusive).

Respuesta

dataarray<object>
has_moreboolean
next_cursorstring

Errores

Ejemplo

curl "https://api.mb-suite.com/v1/crm/calls" \
  -H "Authorization: Bearer $MB_API_KEY"

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

curl "https://api.mb-suite.com/v1/crm/calls" \
  -H "Authorization: Bearer $MB_TEST_KEY"
POST/v1/crm/calls/{call_sid}/outcome

Save the notes and disposition of a call

crm.calls.save_outcome

EscrituraIdempotenteDesde 2026-11-01

Saves the seller's notes (up to 5,000 characters) and the disposition of a call: sale, follow_up, voicemail, no_answer, wrong_number or other. Both go to the call and to its CRM activity (notes become the activity description, the disposition sets the call outcome), creating the activity if the call matches a person or deal. unlinked: true means the call matches nothing in the CRM: link it with crm.calls.link_entity. Requires full access to Phones. Module: Phones (crm_phones), even though the id starts with crm.; the credential needs the crm_phones:write scope.

Alcance
crm_phones:write
Permiso
Editar en el módulo
Tool del MCP
crm_calls_save_outcomeEn la superficie completa; en la compacta, mb_execute_operation con id: "crm.calls.save_outcome".

Costo declarado: hasta 12 lecturas y 30 escrituras por llamada (cuentan en el cupo diario).

Parámetros

call_sidstringrutarequerido

The call: its id (Twilio's call_sid) from crm.calls.list.

notesstringcuerpoopcional

The seller's notes (up to 5,000 characters); they become the call activity's description.

dispositionenumcuerpoopcional

How the call ended: sale, follow_up, voicemail, no_answer, wrong_number or other.

Valores: sale, follow_up, voicemail, no_answer, wrong_number, other

Respuesta

activity_idstring | null
unlinkedboolean

Errores

Ejemplo

curl -X POST "https://api.mb-suite.com/v1/crm/calls/{call_sid}/outcome" \
  -H "Authorization: Bearer $MB_API_KEY"

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

curl -X POST "https://api.mb-suite.com/v1/crm/calls/{call_sid}/outcome" \
  -H "Authorization: Bearer $MB_TEST_KEY"