Email

List the From addresses for Contacts emails

contacts.email.list_senders

Lists the From addresses this person can use with contacts.email.send: the senders of the organization's verified email domain (for agency people working in an Account, also the agency's, with ids that start with agency:). A member only gets their own address. Empty when no verified domain applies: then sending is not available (the organization has to verify its domain in Settings). Returns the senders and default_sender_id.

Alcance

contacts:read

Permiso

Ver el módulo

Tool del MCP

contacts_email_list_sendersEn la superficie completa; en la compacta, mb_execute_operation con id: "contacts.email.list_senders".

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

Parámetros

Sin parámetros.

Respuesta

Errores

Ejemplo

curl "https://api.mb-suite.com/v1/contacts/email/senders" \
  -H "Authorization: Bearer $MB_API_KEY"

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 "https://api.mb-suite.com/v1/contacts/email/senders" \
  -H "Authorization: Bearer $MB_TEST_KEY"

Send an email from Contacts

contacts.email.send

SENDS an email (Amazon SES), like the compose window of the Contacts screen: to (1 to 20 addresses), cc (up to 20; addresses already in to are dropped), subject, html (the body; it is sanitized before sending: scripts, forms, iframes and event handlers are removed) and sender_id (one of contacts.email.list_senders; MB Suite's own address is not allowed here). The body goes inside the organization's email layout with the brand of the sender (logo, name, color). It reaches real inboxes and cannot be undone: outside the app it always runs in two steps — dry_run=true runs the same checks (sender allowed, body not empty) and says from which address, with which subject and to whom it goes, with a confirm_token (10 minutes); then call it again with the confirm_token. Confirm the recipients and the content with the person first. Returns the provider message_id, the From and the final recipients. Errors: sender_not_allowed (403), empty_body; when SES does not take it, external_rejected, external_rate_limited or external_outcome_unknown (the email may have gone out: do not send it again blindly). Requires full access to Contacts.

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

contacts:write

Permiso

Editar en el módulo

Tool del MCP

contacts_email_sendEn la superficie completa; en la compacta, mb_execute_operation con id: "contacts.email.send".

Eventos que puede emitir

contacts.email.sent

Costo declarado: hasta 6 lecturas y 1 escrituras por llamada (cuentan en el cupo diario). Toca una plataforma externa (ses): cuenta en el cupo de operaciones externas.

Parámetros

Respuesta

Errores

Ejemplo

curl -X POST "https://api.mb-suite.com/v1/contacts/email/send" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "to": [
    "TO"
  ],
  "subject": "SUBJECT",
  "html": "HTML",
  "sender_id": "SENDER_ID",
  "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. En la práctica esta operación no se simula (toca otra plataforma): responde 409 sandbox_external_unavailable.