Email the month's planning
social_planner.planning.share
SENDS an email (Amazon SES) with the Social Planner grid of a month (month_key YYYY-MM): every post of the month with date, networks, format, status, labels, text and thumbnail, plus a status and network summary; with format pdf the month's PDF is attached too. All recipients go in one email (to up to 20, cc up to 20). sender_id picks the From among the senders this person can use (the organization's domain senders; none or __system__ = MB Suite); 403 sender_not_allowed otherwise. The send is recorded in the planning share history. With format pdf, 503 pdf_unavailable when the PDF service is not available (nothing is sent). If Amazon SES does not take the email: 409 external_rejected, 429 external_rate_limited, 503 external_unavailable (it surely did not go out) or 409 external_outcome_unknown (it may have gone out: check before sending again). It reaches real inboxes: outside the screen it needs a dry run and a confirm_token; the dry run says the recipients, the From, the month, the format and how many posts go, and social_planner.planning.preview gives the HTML. Dates and times are the posts' own time zone (or the organization's); locale (es, en, pt-BR; default es) sets the email's language. Requires full access to the Social Planner.
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
social_planner:write- Permiso
- Editar en el módulo
- Tool del MCP
social_planner_planning_shareEn la superficie completa; en la compacta,mb_execute_operationconid: "social_planner.planning.share".
Costo declarado: hasta 260 lecturas y 2 escrituras por llamada (cuentan en el cupo diario). Toca una plataforma externa (ses): cuenta en el cupo de operaciones externas.
Parámetros
month_keystringcuerpoThe month, YYYY-MM (like 2026-10), in the organization's time zone.
formatenumcuerpohtml = the email with the month's grid; pdf = a short email with the month's PDF attached.
Valores: pdf, html
toarray<string>cuerpoRecipients (1 to 20); all of them go in one email.
subjectstringcuerpoSubject of the email.
ccarray<string>cuerpoopcionalCopy recipients (up to 20).
personal_notestringcuerpoopcionalOptional personal note shown on top of the email, signed with the sender's name.
sender_idstringcuerpoopcionalThe From: a sender id of the organization's domain senders (the ones this person can use), or __system__ / nothing for MB Suite. It also decides the email's branding.
localeenumcuerpoopcionalLanguage of the email (es, en or pt-BR): texts, statuses, formats, month and dates. Default es.
Valores: es, en, pt-BR
Respuesta
share_idstringpost_countnumberemail_idstringErrores
Ejemplo
curl -X POST "https://api.mb-suite.com/v1/social-planner/planning/share" \
-H "Authorization: Bearer $MB_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"month_key": "MONTH_KEY",
"format": "pdf",
"to": [
"TO"
],
"subject": "SUBJECT",
"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.