Remitentes

Add a sender

branding.email_senders.add

Adds a sender address on the verified sending domain: email (the full address, hello@youragency.com: it must be on that domain, 400 sender_email_domain_mismatch otherwise) and name (what recipients see, up to 100 characters). Requires the domain to be verified (409 email_domain_not_verified); an address already in the list is 409 sender_exists; up to 50 senders (409 limit_reached, details.resource email_senders). The first sender in the list is the default From; a new one goes last (reorder with branding.email_senders.reorder). Returns the new sender and the whole list. Owners and admins with edit access to Branding.

Alcance

branding:write

Permiso

Editar en el módulo · Solo owner, admin

Tool del MCP

branding_email_senders_addEn la superficie completa; en la compacta, mb_execute_operation con id: "branding.email_senders.add".

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

Parámetros

Respuesta

Errores

Ejemplo

curl -X POST "https://api.mb-suite.com/v1/branding/email-senders" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "email": "ana@example.com",
  "name": "NAME"
}'

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/branding/email-senders" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "email": "ana@example.com",
  "name": "NAME"
}'

Rename a sender

branding.email_senders.update

Changes the display name of a sender (name, up to 100 characters); the address itself does not change (remove the sender and add another). The same name changes nothing (changed false). Not found if the sender id is not in the list. Returns the sender and the whole list. Owners and admins with edit access to Branding.

Alcance

branding:write

Permiso

Editar en el módulo · Solo owner, admin

Tool del MCP

branding_email_senders_updateEn la superficie completa; en la compacta, mb_execute_operation con id: "branding.email_senders.update".

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

Parámetros

Respuesta

Errores

Ejemplo

curl -X PATCH "https://api.mb-suite.com/v1/branding/email-senders/{sender_id}" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "NAME"
}'

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 PATCH "https://api.mb-suite.com/v1/branding/email-senders/{sender_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "NAME"
}'

Reorder the senders

branding.email_senders.reorder

Sets the order of the senders: sender_ids lists every sender id exactly once, in the new order (400 sender_ids_mismatch otherwise). The first one becomes the default From for the emails that do not pick a sender (flows, reports, shared emails), so this is a real change, not a display preference. The same order changes nothing (changed false). Returns the list. Owners and admins with edit access to Branding.

Alcance

branding:write

Permiso

Editar en el módulo · Solo owner, admin

Tool del MCP

branding_email_senders_reorderEn la superficie completa; en la compacta, mb_execute_operation con id: "branding.email_senders.reorder".

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

Parámetros

Respuesta

Errores

Ejemplo

curl -X POST "https://api.mb-suite.com/v1/branding/email-senders/reorder" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "sender_ids": [
    "SENDER_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/branding/email-senders/reorder" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "sender_ids": [
    "SENDER_ID"
  ]
}'

Remove a sender

branding.email_senders.remove

Removes a sender from the sending domain. At least one sender always stays (409 last_sender); removing the default one makes the next in the list the default. Emails and drafts that picked this sender fall back to the default. There is no trash: to undo, add it again with the same address and name. Not found if the sender id is not in the list. Outside the app it needs a dry run and its confirm_token. Owners and admins with edit access to Branding.

Pide confirmación: primero dry_run: true (vista previa y confirm_token, que vale 10 minutos y una sola vez), después el mismo cuerpo con confirm_token. En unas pocas, solo con ciertos datos: la descripción dice cuándo. Por qué y cómo: Vista previa y confirmación.

Alcance

branding:write y «Permitir eliminar» (branding:delete en OAuth)

Permiso

Editar en el módulo · Solo owner, admin

Tool del MCP

branding_email_senders_removeEn la superficie completa; en la compacta, mb_execute_operation con id: "branding.email_senders.remove".

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

Parámetros

Respuesta

Errores

Ejemplo

curl -X DELETE "https://api.mb-suite.com/v1/branding/email-senders/{sender_id}" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "dry_run": true
}'

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 DELETE "https://api.mb-suite.com/v1/branding/email-senders/{sender_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "dry_run": true
}'