MB SuiteMB Suite
Menú

Referencia de la API · Phones

Configuración por usuario

crm_phones · user_settings · 1 operación

POST/v1/phones/users/{user_id}/default-line
POST/v1/phones/users/{user_id}/default-line

Set a person's default outgoing line

crm_phones.user_settings.set_default_line

EscrituraIdempotenteDesde 2026-11-01

Sets the line a person calls from by default in the Phones dialer (line_id), or clears it with line_id=null (the dialer then picks the line by the destination's country). The person (user_id in the path) must be a member of the organization (user_not_member); the line must be an active line of the organization (line_not_found, line_not_active) and not dedicated to WhatsApp (line_whatsapp_locked: those lines do not place calls). Anyone with view access to Phones can set their own; setting another person's requires edit access. Idempotent. Returns user_id and default_line_id.

Alcance
crm_phones:write
Permiso
Ver el módulo
Tool del MCP
crm_phones_user_settings_set_default_lineEn la superficie completa; en la compacta, mb_execute_operation con id: "crm_phones.user_settings.set_default_line".

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

Parámetros

user_idstringrutarequerido

A member: a user_id from crm.team.list (with access to Phones).

line_idstring | nullcuerporequerido

The phone line: an id from crm_phones.lines.list. null clears the preference (the phone picks the line by country again).

Respuesta

user_idstring
default_line_idstring | null

Errores

invalid_inputunknown_fieldauthentication_requiredscope_insufficientcrm_action_deniedidempotency_key_reusedrate_limitedquota_exceeded

Ejemplo

curl -X POST "https://api.mb-suite.com/v1/phones/users/{user_id}/default-line" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "line_id": "LINE_ID"
}'

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/users/{user_id}/default-line" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "line_id": "LINE_ID"
}'