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.
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
social_planner:write- Permissão
- Editar no módulo
- Tool do MCP
social_planner_planning_shareNa superfície completa; na compacta,mb_execute_operationcomid: "social_planner.planning.share".
Custo declarado: até 260 leituras e 2 escritas por chamada (contam na cota diária). Usa uma plataforma externa (ses): conta na cota de operações externas.
Parâmetros
month_keystringcorpoThe month, YYYY-MM (like 2026-10), in the organization's time zone.
formatenumcorpohtml = the email with the month's grid; pdf = a short email with the month's PDF attached.
Valores: pdf, html
toarray<string>corpoRecipients (1 to 20); all of them go in one email.
subjectstringcorpoSubject of the email.
ccarray<string>corpoopcionalCopy recipients (up to 20).
personal_notestringcorpoopcionalOptional personal note shown on top of the email, signed with the sender's name.
sender_idstringcorpoopcionalThe 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.
localeenumcorpoopcionalLanguage of the email (es, en or pt-BR): texts, statuses, formats, month and dates. Default es.
Valores: es, en, pt-BR
Resposta
share_idstringpost_countnumberemail_idstringErros
Exemplo
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
}'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.