Solicitação de acesso

Ask MB Suite to enable Phones

crm_phones.access.request

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).

Escopo

organizations:write

Permissão

Ver o módulo

Tool do MCP

crm_phones_access_requestNa superfície completa; na compacta, mb_execute_operation com id: "crm_phones.access.request".

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

Parâmetros

Resposta

Erros

Exemplo

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
}'

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/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
}'