E-mail

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.

Escopo

contacts:read

Permissão

Ver o módulo

Tool do MCP

contacts_email_list_sendersNa superfície completa; na compacta, mb_execute_operation com id: "contacts.email.list_senders".

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

Parâmetros

Sem parâmetros.

Resposta

Erros

Exemplo

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

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

Pede confirmação: primeiro dry_run: true (prévia e confirm_token, válido por 10 minutos e por uma única execução), depois o mesmo corpo com confirm_token. Em algumas poucas, só com certos dados: a descrição diz quando. Por que e como: Prévia e confirmação.

Escopo

contacts:write

Permissão

Editar no módulo

Tool do MCP

contacts_email_sendNa superfície completa; na compacta, mb_execute_operation com id: "contacts.email.send".

Eventos que pode emitir

contacts.email.sent

Custo declarado: até 6 leituras e 1 escritas por chamada (contam na cota diária). Usa uma plataforma externa (ses): conta na cota de operações externas.

Parâmetros

Resposta

Erros

Exemplo

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

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. Na prática esta operação não é simulada (usa outra plataforma): responde 409 sandbox_external_unavailable.