Dominio de email

Get the sending domain

branding.email_domain.get

Returns the organization's email sending domain as saved: domain, status (pending until the DNS records are confirmed, then verified), added_at, verified_at, dns_records (the TXT for DKIM, the MX and the SPF TXT of the MAIL FROM subdomain, each with verified) and senders (the addresses on that domain, in order; the first is the default From), plus footer_address (the postal address printed in commercial emails). configured false when there is none. effective_domain is the domain branded emails actually go out from: the organization's own if verified, else its workspace's verified one (inherited_from_parent true), else null (MB Suite's address). It calls no external provider: branding.email_domain.verify refreshes the status. Requires view access to Branding.

Alcance

branding:read

Permiso

Ver el módulo

Tool del MCP

branding_email_domain_getEn la superficie completa; en la compacta, mb_execute_operation con id: "branding.email_domain.get".

Costo declarado: hasta 2 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/branding/email-domain" \
  -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/branding/email-domain" \
  -H "Authorization: Bearer $MB_TEST_KEY"

Add the sending domain

branding.email_domain.add

Registers the domain the organization will send emails from (campaigns, flows, reports and shared emails with its brand): the root domain it owns (youragency.com; a leading send., mail., email., bounce. or reply. is dropped; never mb-suite.com). Creates the identity in the email provider and returns dns_records: a TXT record for DKIM and the MX and SPF TXT of the send. subdomain, to publish at the registrar; then branding.email_domain.verify. One sending domain per organization: with one already set, 409 email_domain_already_set (remove it first); a domain another organization already uses, 409 email_domain_in_use. 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

Permiso

Editar en el módulo · Solo owner, admin

Tool del MCP

branding_email_domain_addEn la superficie completa; en la compacta, mb_execute_operation con id: "branding.email_domain.add".

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/branding/email-domain" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "domain": "DOMAIN",
  "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.

Verify the sending domain's DNS

branding.email_domain.verify

Checks the sending domain with the email provider and, on its own, against the domain's authoritative DNS; saves the status and the dns_records with their verified flags. Returns verified and, while pending, reason_code: dns_not_found (the records are not published), dns_invalid (published with another value), dns_found_confirming (we see them, the provider is confirming: minutes) or dns_pending. If the provider had given up looking (it stops after 72 hours), the search is restarted automatically (restarted). When the domain becomes verified it fires branding.email_domain.verified once and its senders can be used. Not found without a sending domain. 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_domain_verifyEn la superficie completa; en la compacta, mb_execute_operation con id: "branding.email_domain.verify".

Eventos que puede emitir

branding.email_domain.verified

Costo declarado: hasta 1 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

Sin parámetros.

Respuesta

Errores

Ejemplo

curl -X POST "https://api.mb-suite.com/v1/branding/email-domain/verify" \
  -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. En la práctica esta operación no se simula (toca otra plataforma): responde 409 sandbox_external_unavailable.

Remove the sending domain

branding.email_domain.remove

Removes the organization's sending domain and all its senders: the identity is deleted from the email provider and branded emails go back to MB Suite's address (or to the workspace's domain, for an Account); Email Marketing campaigns and flows need a verified domain again. The DNS records at the registrar are not touched. There is no trash: to undo, add the domain again (the same records apply) and re-create the senders. Not found without a sending domain. 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_domain_removeEn la superficie completa; en la compacta, mb_execute_operation con id: "branding.email_domain.remove".

Costo declarado: hasta 1 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

Sin parámetros.

Respuesta

Errores

Ejemplo

curl -X DELETE "https://api.mb-suite.com/v1/branding/email-domain" \
  -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. En la práctica esta operación no se simula (toca otra plataforma): responde 409 sandbox_external_unavailable.