Access request

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

Scope

organizations:write

Permission

View the module

MCP tool

crm_phones_access_requestOn the full surface; on the compact one, mb_execute_operation with id: "crm_phones.access.request".

Declared cost: up to 6 reads and 1 writes per call (they count against the daily quota).

Parameters

Response

Errors

Example

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

Try it with your test API key

With a test API key the request always goes to your practice organization: example data you can reset.

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