MB SuiteMB Suite
Menú

Referencia de la API · Email Marketing

Reportes

email_marketing · reports · 1 operación

GET/v1/email-marketing/reports
GET/v1/email-marketing/reports

Get email marketing performance for a date range

email_marketing.reports.get

LecturaIdempotenteDesde 2026-11-01

Returns the performance of the emails sent between start_date and end_date (epoch ms, up to 400 days): overview (sent, delivered, opened, clicked, bounced and open/click/bounce rates over delivered or sent), daily (one row per day, zero-filled), campaigns (sent or sending campaigns in the range with their stats and rates) and flows (every flow with what it sent in the range). types picks campaign and/or flow emails for overview and daily; sections picks what to return. With an API key or an app at most 20,000 sent emails are read per call, oldest first (truncated true means narrow the range) and at most 500 campaigns and flows. Requires view access to Email Marketing.

Alcance
email_marketing:read
Permiso
Ver el módulo
Tool del MCP
email_marketing_reports_getEn la superficie completa; en la compacta, mb_execute_operation con id: "email_marketing.reports.get".

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

Parámetros

start_dateintegerqueryrequerido

From (epoch ms).

end_dateintegerqueryrequerido

To (epoch ms; up to 400 days after start_date).

typesarray<enum>queryopcional

Which sends the overview and the daily series count: campaign, flow or both (default).

Valores: campaign, flow · Por defecto: ["campaign","flow"]

sectionsarray<enum>queryopcional

Which parts to return: overview, daily, campaigns, flows (default all).

Valores: overview, daily, campaigns, flows · Por defecto: ["overview","daily","campaigns","flows"]

Respuesta

truncatedboolean
logs_readnumber
overviewobject
dailyarray<object>

One row per day of the range (UTC days), zero-filled.

campaignsarray<object>
flowsarray<object>

Errores

invalid_inputunknown_fieldauthentication_requiredscope_insufficientmodule_access_deniedoperation_not_foundrate_limitedquota_exceeded

Ejemplo

curl "https://api.mb-suite.com/v1/email-marketing/reports?start_date=946684800000&end_date=946684800000" \
  -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/email-marketing/reports?start_date=946684800000&end_date=946684800000" \
  -H "Authorization: Bearer $MB_TEST_KEY"