Menú

Referencia de la API · Organización

Solicitud de acceso

organizations · access · 1 operación

POST/v1/phones/access-requests

Ask MB Suite to enable Phones

crm_phones.access.request

EscrituraDesde 2026-11-01

Asks MB Suite to enable Phones (phone numbers, calls and SMS) for the organization: what it will be used for (use_case, 20 to 2000 characters), the countries where it needs numbers (ISO codes like AR, MX, US; 1 to 30) and the estimated monthly spend in USD (integer, 0 if unknown). MB Suite reviews every request within one business day and emails the decision to the person who asked; Phones is enabled when the subscription's paid cycle starts. Only one request can be pending at a time (access_request_pending, with its request_id in details). A direct member of the organization, an owner or admin of it or of its workspace can ask. Returns the request id. Module: Organization (organizations), even though the id starts with crm_phones.; it is not available to API keys or OAuth tokens (none can be given write access to organizations).

Instrucciones para agentes

Tell the person MB Suite reviews the request within one business day and emails them the decision.

Alcance
organizations:write
Permiso
Ver el módulo
Tool del MCP
crm_phones_access_requestEn la superficie completa; en la compacta, mb_execute_operation con id: "crm_phones.access.request".

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

Parámetros

use_casestringcuerporequerido

What the organization will use phone lines for (20 to 2,000 characters): MB Suite reviews it.

countriesarray<string>cuerporequerido

The countries of the numbers it needs (ISO codes: AR, MX, US…).

estimated_monthly_usdintegercuerporequerido

The estimated monthly spend in USD.

Respuesta

request_idstring
status"pending"

Errores

Ejemplo

curl -X POST "https://api.mb-suite.com/v1/phones/access-requests" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "use_case": "USE_CASE",
  "countries": [
    "COUNTRIE"
  ],
  "estimated_monthly_usd": 0
}'

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/phones/access-requests" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "use_case": "USE_CASE",
  "countries": [
    "COUNTRIE"
  ],
  "estimated_monthly_usd": 0
}'