Email marketing y transaccional AI-native: campañas, correos 1-a-1, contactos, flujos y métricas.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Métricas globales de la cuenta (enviados, entregados, abrieron, hicieron clic, bajas, rebotes, contactos nuevos) en un rango de días de la zona horaria de la cuenta, ambos incluidos; la cohorte es el día de ENVÍO de cada correo, la misma fuente que /metricas. avg_open_rate y avg_click_rate en % con 2 decimales sobre ENTREGADOS (avg_*_rate_fraction: alias deprecados en fracción). Si hay días aún sin calcular responde 503 metrics_recalculating: reintenta, nunca son sumas parciales. Rebote separado: bounced_hard / bounce_rate_hard (definitivo, el que se vigila) y bounced_soft / bounce_rate_soft (temporal), en % sobre enviados (bounce_rates_base: "sent"); null si el período no tiene el tipo medido, nunca un 0 inventado. total_bounces = definitivos + temporales. Ojo: en la ficha de campaña (get_campaign_stats) el mismo dato se llama bounce_hard_rate.
Fecha fin YYYY-MM-DD (opcional).
Fecha inicio YYYY-MM-DD (opcional).
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Métricas globales de la cuenta (enviados, entregados, abrieron, hicieron clic, bajas, rebotes, contactos nuevos) en un rango de días de la zona horaria de la cuenta, ambos incluidos; la cohorte es el día de ENVÍO de cada correo, la misma fuente que /metricas. avg_open_rate y avg_click_rate en % con 2 decimales sobre ENTREGADOS (avg_*_rate_fraction: alias deprecados en fracción). Si hay días aún sin calcular responde 503 metrics_recalculating: reintenta, nunca son sumas parciales. Rebote separado: bounced_hard / bounce_rate_hard (definitivo, el que se vigila) y bounced_soft / bounce_rate_soft (temporal), en % sobre enviados (bounce_rates_base: "sent"); null si el período no tiene el tipo medido, nunca un 0 inventado. total_bounces = definitivos + temporales. Ojo: en la ficha de campaña (get_campaign_stats) el mismo dato se llama bounce_hard_rate.
| Argument | Type | Description |
|---|---|---|
| to | string | Fecha fin YYYY-MM-DD (opcional). |
| from | string | Fecha inicio YYYY-MM-DD (opcional). |
{
"type": "object",
"properties": {
"to": {
"type": "string",
"description": "Fecha fin YYYY-MM-DD (opcional)."
},
"from": {
"type": "string",
"description": "Fecha inicio YYYY-MM-DD (opcional)."
}
}
}Pone la automatización en servicio (status active) o la pausa con paused:true. OJO: activar NO hace que envíe — para eso hace falta armarla (arm_flow).
| Argument | Type | Description |
|---|---|---|
| paused | boolean | true para pausar en vez de activar. |
| flow_id* | string |
{
"type": "object",
"required": [
"flow_id"
],
"properties": {
"paused": {
"type": "boolean",
"description": "true para pausar en vez de activar."
},
"flow_id": {
"type": "string"
}
}
}Añade un contacto (por email o contact_id) a una lista.
| Argument | Type | Description |
|---|---|---|
| string | ||
| list_id* | string | ID de la lista. |
| contact_id | string |
{
"type": "object",
"required": [
"list_id"
],
"properties": {
"email": {
"type": "string"
},
"list_id": {
"type": "string",
"description": "ID de la lista."
},
"contact_id": {
"type": "string"
}
}
}ARMA la automatización: a partir de aquí envía correos REALES sola. Exige confirm:"ARMAR ENVIOS" literal, haber probado el flujo antes, y que la cuenta permita envíos por agente. NO es retroactivo: solo entra quien cumpla el disparador de ahora en adelante.
| Argument | Type | Description |
|---|---|---|
| confirm* | string | Tiene que ser exactamente "ARMAR ENVIOS". |
| flow_id* | string | |
| acknowledge_no_list_filter | boolean | Obligatorio si el disparador es "cualquier lista". |
{
"type": "object",
"required": [
"flow_id",
"confirm"
],
"properties": {
"confirm": {
"type": "string",
"description": "Tiene que ser exactamente \"ARMAR ENVIOS\"."
},
"flow_id": {
"type": "string"
},
"acknowledge_no_list_filter": {
"type": "boolean",
"description": "Obligatorio si el disparador es \"cualquier lista\"."
}
}
}Saca de circulación a los contactos activos que tienen un rebote PERMANENTE (la dirección no existe) o 3 rebotes temporales seguidos sin ninguna señal de vida entre medio (ni entregado, ni abierto, ni clic). Un rebote temporal suelto, como un buzón lleno, nunca saca a nadie. Deja escrito el motivo en el contacto. Sin `aplicar:true` solo devuelve el recuento por motivo, no cambia nada.
| Argument | Type | Description |
|---|---|---|
| aplicar | boolean | false (por defecto) = simulacro, devuelve el recuento sin tocar nada. true = ejecuta la supresión. |
| list_id | string | Limitar la limpieza a una lista. Si se omite, aplica a toda la cuenta. |
{
"type": "object",
"properties": {
"aplicar": {
"type": "boolean",
"description": "false (por defecto) = simulacro, devuelve el recuento sin tocar nada. true = ejecuta la supresión."
},
"list_id": {
"type": "string",
"description": "Limitar la limpieza a una lista. Si se omite, aplica a toda la cuenta."
}
}
}Crea una automatización. NACE EN BORRADOR Y DESARMADA: no envía nada hasta que se pruebe, se active y se arme a propósito. El `graph` es el mismo formato que devuelve get_flow.
| Argument | Type | Description |
|---|---|---|
| name* | string | |
| graph | object | Pasos: {"nodes":[{"id":"1","type":"email","label":"...","config":{"subject":"...","blocks":[...]},"next":"2"}],"edges":[]}. |
| trigger_type | string | list_subscribe | tag_added | form_submit | date_relative | birthday | abandoned_cart | api | manual… |
| trigger_config | object | Config del disparador (p. ej. {"list_id":"..."}). |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
},
"graph": {
"type": "object",
"description": "Pasos: {\"nodes\":[{\"id\":\"1\",\"type\":\"email\",\"label\":\"...\",\"config\":{\"subject\":\"...\",\"blocks\":[...]},\"next\":\"2\"}],\"edges\":[]}.",
"additionalProperties": true
},
"trigger_type": {
"type": "string",
"description": "list_subscribe | tag_added | form_submit | date_relative | birthday | abandoned_cart | api | manual…"
},
"trigger_config": {
"type": "object",
"description": "Config del disparador (p. ej. {\"list_id\":\"...\"}).",
"additionalProperties": true
}
}
}Crea un formulario de captación y devuelve su URL pública y su código para embeber. Si no pasas campos, lleva uno de correo.
| Argument | Type | Description |
|---|---|---|
| name* | string | |
| fields | array | Campos: [{name,type,label,required}]. Debe incluir uno "email". |
| list_id | string | Lista donde caen las altas. |
| display_mode | string | inline | popup. |
| double_optin | boolean | |
| thank_you_message | string |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
},
"fields": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"description": "Campos: [{name,type,label,required}]. Debe incluir uno \"email\"."
},
"list_id": {
"type": "string",
"description": "Lista donde caen las altas."
},
"display_mode": {
"type": "string",
"description": "inline | popup."
},
"double_optin": {
"type": "boolean"
},
"thank_you_message": {
"type": "string"
}
}
}Crea una página de aterrizaje y devuelve su URL pública. `kind`: blocks (bloques de Postari) · code (HTML propio) · ai (desde un prompt) · iframe · external_url. Conéctale un formulario con form_id para que capte suscriptores.
| Argument | Type | Description |
|---|---|---|
| kind | string | blocks | code | ai | iframe | external_url. Default: blocks. |
| name* | string | |
| slug* | string | Va en la URL /l/<slug>: minúsculas, números y guiones. |
| blocks | array | Contenido si kind=blocks. |
| form_id | string | Formulario que se muestra en la página. |
| ai_prompt | string | Instrucción si kind=ai. |
| html_code | string | HTML si kind=code. |
| iframe_url | string | |
| external_url | string |
{
"type": "object",
"required": [
"name",
"slug"
],
"properties": {
"kind": {
"type": "string",
"description": "blocks | code | ai | iframe | external_url. Default: blocks."
},
"name": {
"type": "string"
},
"slug": {
"type": "string",
"description": "Va en la URL /l/<slug>: minúsculas, números y guiones."
},
"blocks": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"description": "Contenido si kind=blocks."
},
"form_id": {
"type": "string",
"description": "Formulario que se muestra en la página."
},
"ai_prompt": {
"type": "string",
"description": "Instrucción si kind=ai."
},
"html_code": {
"type": "string",
"description": "HTML si kind=code."
},
"iframe_url": {
"type": "string"
},
"external_url": {
"type": "string"
}
}
}Crea un LANZAMIENTO (curso, infoproducto, evento…) con sus etapas: es la unidad que agrupa los correos de una campaña con fechas. Si no pasas `stages` y el tipo es curso/infoproducto, siembra 8 etapas estándar (lead magnet → webinar → apertura de carrito → cierre).
| Argument | Type | Description |
|---|---|---|
| kind | string | curso | membresía | infoproducto | evento | servicio | otro. Default: curso. |
| name* | string | Nombre del lanzamiento. |
| stages | array | Etapas explícitas: [{kind,title,scheduled_at}]. |
| ends_at | string | Fecha de cierre en ISO 8601. |
| starts_at | string | Fecha de inicio en ISO 8601. |
| seed_default_stages | boolean | false para crearlo SIN etapas. Default: true en curso/infoproducto. |
| target_revenue_cents | number | Objetivo de facturación en céntimos (opcional). |
{
"type": "object",
"required": [
"name"
],
"properties": {
"kind": {
"type": "string",
"description": "curso | membresía | infoproducto | evento | servicio | otro. Default: curso."
},
"name": {
"type": "string",
"description": "Nombre del lanzamiento."
},
"stages": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"description": "Etapas explícitas: [{kind,title,scheduled_at}]."
},
"ends_at": {
"type": "string",
"description": "Fecha de cierre en ISO 8601."
},
"starts_at": {
"type": "string",
"description": "Fecha de inicio en ISO 8601."
},
"seed_default_stages": {
"type": "boolean",
"description": "false para crearlo SIN etapas. Default: true en curso/infoproducto."
},
"target_revenue_cents": {
"type": "number",
"description": "Objetivo de facturación en céntimos (opcional)."
}
}
}Crea una nueva lista de contactos.
| Argument | Type | Description |
|---|---|---|
| name* | string | Nombre de la lista. |
| description | string |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Nombre de la lista."
},
"description": {
"type": "string"
}
}
}Crea un segmento: una regla de "quién entra" que se recalcula sola. Es lo que se usa para segmentar un lanzamiento sin duplicar listas.
| Argument | Type | Description |
|---|---|---|
| name* | string | |
| definition* | object | Reglas del segmento (mismo JSON que la UI de /segmentos). |
| description | string |
{
"type": "object",
"required": [
"name",
"definition"
],
"properties": {
"name": {
"type": "string"
},
"definition": {
"type": "object",
"description": "Reglas del segmento (mismo JSON que la UI de /segmentos).",
"additionalProperties": true
},
"description": {
"type": "string"
}
}
}Crea o actualiza (upsert) un contacto/suscriptor. Si ya existe, lo actualiza sin duplicar.
| Argument | Type | Description |
|---|---|---|
| tags | array | Etiquetas a aplicar. |
| email* | string | Correo del contacto (requerido). |
| phone | string | |
| country | string | Código ISO de país, ej "CO". |
| metadata | object | Campos personalizados. |
| last_name | string | |
| first_name | string |
{
"type": "object",
"required": [
"email"
],
"properties": {
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Etiquetas a aplicar."
},
"email": {
"type": "string",
"description": "Correo del contacto (requerido)."
},
"phone": {
"type": "string"
},
"country": {
"type": "string",
"description": "Código ISO de país, ej \"CO\"."
},
"metadata": {
"type": "object",
"description": "Campos personalizados.",
"additionalProperties": true
},
"last_name": {
"type": "string"
},
"first_name": {
"type": "string"
}
}
}Crea una etiqueta (idempotente: si ya existe devuelve la que hay, no la duplica).
| Argument | Type | Description |
|---|---|---|
| name* | string | |
| color | string |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
},
"color": {
"type": "string"
}
}
}Crea una plantilla propia de la cuenta, opcionalmente duplicando una del catálogo con from_template_id. Las del catálogo son compartidas y no se editan.
| Argument | Type | Description |
|---|---|---|
| name* | string | |
| blocks | array | |
| subject | string | |
| category | string | |
| preheader | string | |
| description | string | |
| from_template_id | string | Duplica esta plantilla como punto de partida. |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
},
"blocks": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"subject": {
"type": "string"
},
"category": {
"type": "string"
},
"preheader": {
"type": "string"
},
"description": {
"type": "string"
},
"from_template_id": {
"type": "string",
"description": "Duplica esta plantilla como punto de partida."
}
}
}Diagnóstico de ENTREGABILIDAD de la cuenta (últimos 28 días): rebotes, quejas de spam, aperturas y salud del dominio (DNS). Devuelve un veredicto (sano/a_vigilar/en_riesgo) + acciones priorizadas. El rebote que se juzga (`bounce_rate`) es el DEFINITIVO; el temporal (buzón lleno) va aparte en `bounce_rate_temporal`. Tasas en % con 2 decimales: rebotes y quejas sobre ENVIADOS (umbrales sanos <2 % y <0,1 %); open_rate sobre ENTREGADOS, como account_stats. Úsalo antes de un envío grande o si los correos no llegan.
No arguments.
{
"type": "object",
"properties": {}
}Transparencia "qué hizo la IA": lista las acciones de la cuenta originadas por un agente/IA (chat Atelier, API de agente, A2A) — qué se hizo, sobre qué y cuándo. Para auditar lo que un agente ejecutó.
| Argument | Type | Description |
|---|---|---|
| limit | number | 1-100, default 50. |
{
"type": "object",
"properties": {
"limit": {
"type": "number",
"description": "1-100, default 50."
}
}
}¿A cuánta gente le va a llegar este correo? Devuelve los destinatarios REALES aplicando el filtro guardado, por el mismo camino que el envío: base = activos de la lista hoy, excluidos = los que quita el filtro, audience_live_total = el público de HOY. Si ya empezó a enviarse trae además recipients_snapshot (la foto del primer tick), excluded_on_send (tope de frecuencia y dominios bloqueados) y remaining_to_send. total_recipients es un alias deprecado de audience_live_total.
| Argument | Type | Description |
|---|---|---|
| campaign_id* | string |
{
"type": "object",
"required": [
"campaign_id"
],
"properties": {
"campaign_id": {
"type": "string"
}
}
}Métricas reales de una campaña leídas de los eventos en vivo: enviados, entregados, abrieron (únicos y aperturas registradas), clics únicos y registrados, clics de sistema, rebotes (bounce_hard_rate = definitivo, el que se vigila), bajas, quejas, ingresos USD atribuidos (ventas con clic o, sin clic, apertura de este correo antes de comprar; si la persona solo lo recibió la venta es «influida» y NO suma) y by_link (clics de contenido por URL). maturity: sending/paused = parcial, settling = enviada hace menos de 24 h. stale true = la lectura falló y las cifras no son de fiar. Definiciones: enviados = correos con sent_at; entregados = enviados − rebotados; abrieron = correos con apertura (píxel, webhook o clic); clics únicos = correos con clic en un enlace de contenido (baja, preferencias y pie aparte en clicked_system). Tasas en % con 2 decimales: entrega y rebote sobre ENVIADOS; apertura, clic, bajas y quejas sobre ENTREGADOS (rate_base "delivered"); ctor = clics únicos / abrieron. null = sin denominador, nunca 0 inventado. *_fraction son alias heredados en fracción 0-1 (deprecados).
| Argument | Type | Description |
|---|---|---|
| campaign_id* | string | ID de la campaña. |
{
"type": "object",
"required": [
"campaign_id"
],
"properties": {
"campaign_id": {
"type": "string",
"description": "ID de la campaña."
}
}
}Un formulario con sus campos y sus KPIs recontados en vivo (form_kpis_v2): primary_count en primary_unit (people en captura, submissions en encuesta), people, submissions (envíos sin papelera), views, views_measured y conversion_rate (primary_count / views, % con 1 decimal, null si las vistas no están medidas). Mismas definiciones que list_forms. Si la lectura falla responde 503 metrics_unavailable (nunca un número sin avisar).
| Argument | Type | Description |
|---|---|---|
| form_id* | string | ID del formulario. |
{
"type": "object",
"required": [
"form_id"
],
"properties": {
"form_id": {
"type": "string",
"description": "ID del formulario."
}
}
}Un lanzamiento con sus etapas y las MÉTRICAS REALES de cada una (enviados, entregados, abrieron, clics únicos, bajas, ingresos USD atribuidos por clic o apertura, sin las ventas solo «influidas») más el total; cada campaña se suma una sola vez. stages_sent de stages_total = etapas ya enviadas. metrics null en una etapa = todavía no tiene correo (no es 0). Es la forma de saber cómo va un lanzamiento. Definiciones: enviados = correos con sent_at; entregados = enviados − rebotados; abrieron = correos con apertura (píxel, webhook o clic); clics únicos = correos con clic en un enlace de contenido (baja, preferencias y pie aparte en clicked_system). Tasas en % con 2 decimales: entrega y rebote sobre ENVIADOS; apertura, clic, bajas y quejas sobre ENTREGADOS (rate_base "delivered"); ctor = clics únicos / abrieron. null = sin denominador, nunca 0 inventado. *_fraction son alias heredados en fracción 0-1 (deprecados).
| Argument | Type | Description |
|---|---|---|
| launch_id* | string |
{
"type": "object",
"required": [
"launch_id"
],
"properties": {
"launch_id": {
"type": "string"
}
}
}Busca un contacto por su correo y devuelve sus datos, estado, etiquetas e historial básico. Si está rebotado trae `bounce: {tipo, subtipo, fecha, motivo, dominio_sugerido}` (tipo permanente o temporal; motivo rebote_permanente, rebote_temporal_repetido, rebote_temporal o rebote_sin_evento; dominio_sugerido si la dirección parece mal escrita, p. ej. gmail.co → gmail.com); si no, `bounce: null`.
| Argument | Type | Description |
|---|---|---|
| email* | string | Correo a buscar. |
{
"type": "object",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"description": "Correo a buscar."
}
}
}AGÉNTICA · Lanza una campaña de correo COMPLETA desde un brief en lenguaje natural. Postari GENERA el correo (asunto + diseño con la voz y el color de marca del tenant), lo arma sobre una lista y devuelve un BORRADOR con preview (preview_html). Por defecto NO envía: para enviar de verdad, vuelve a llamar con los mismos campos + confirm_send:true (o scheduled_at para agendar). Es la forma de "dile el objetivo y Postari lo logra". Requiere scope `write` (borrador) o `send` (enviar).
| Argument | Type | Description |
|---|---|---|
| goal | string | Objetivo opcional: ventas, reactivación, anuncio, evento… |
| tone | string | Tono opcional: cálido, urgente, divertido, profesional… |
| brief | string | Qué comunicar, en lenguaje natural. Ej: "Black Friday 30% OFF en todos los cursos, tono urgente, cierra el viernes". Postari escribe el correo. |
| blocks | array | Bloques de contenido propios (opcional · alternativa a brief). |
| cta_url | string | URL del botón principal (opcional). |
| list_id* | string | UUID de la lista destino (usa list_lists para verlas). Una lista inteligente no sirve para enviar: 409 smart_list_not_sendable. |
| subject | string | Asunto exacto (opcional · si lo das, no se genera). |
Conecta un correo YA ESCRITO a una etapa del lanzamiento (o lo desconecta con campaign_id null). Sin esto la etapa no mide nada: sus KPIs dependen de este vínculo. También sirve para cambiar título, fecha o estado de la etapa.
| Argument | Type | Description |
|---|---|---|
| title | string | |
| status | string | planned | sent | done | skipped. |
| stage_id* | string | |
| launch_id* | string | |
| campaign_id | string | ID de la campaña a conectar. null para desconectar. |
| scheduled_at | string | ISO 8601. |
{
"type": "object",
"required": [
"launch_id",
"stage_id"
],
"properties": {
"title": {
"type": "string"
},
"status": {
"type": "string",
"description": "planned | sent | done | skipped."
},
"stage_id": {
"type": "string"
},
"launch_id": {
"type": "string"
},
"campaign_id": {
"type": "string",
"description": "ID de la campaña a conectar. null para desconectar."
},
"scheduled_at": {
"type": "string",
"description": "ISO 8601."
}
}
}Lista las campañas/correos del tenant con sus métricas (metrics.*, desde los contadores que mantiene el reconciliador: durante un envío pueden ir unos minutos detrás de get_campaign_stats). En este listado opened_total, clicked_total, clicked_system, delivered_confirmed, failed, bounced_hard, bounced_soft y bounce_hard_rate llegan en null (los contadores no los guardan; null = no medido, no 0): pídelos a get_campaign_stats. audience_count = «¿a cuántos?»: si ya empezó, la foto del envío; en borrador o programada, los ACTIVOS de la lista hoy ANTES del filtro guardado (audience_basis "list_active_before_filters"); el neto exacto lo da get_campaign_audience. Filtrable por estado (draft, scheduled, sending, sent). Definiciones: enviados = correos con sent_at; entregados = enviados − rebotados; abrieron = correos con apertura (píxel, webhook o clic); clics únicos = correos con clic en un enlace de contenido (baja, preferencias y pie aparte en clicked_system). Tasas en % con 2 decimales: entrega y rebote sobre ENVIADOS; apertura, clic, bajas y quejas sobre ENTREGADOS (rate_base "delivered"); ctor = clics únicos / abrieron. null = sin denominador, nunca 0 inventado. *_fraction son alias heredados en fracción 0-1 (deprecados).
| Argument | Type | Description |
|---|---|---|
| limit | number | 1-500, default 20. |
| status | string | Filtro de estado (opcional). |
{
"type": "object",
"properties": {
"limit": {
"type": "number",
"description": "1-500, default 20."
},
"status": {
"type": "string",
"description": "Filtro de estado (opcional)."
}
}
}Los correos de una automatización, cada uno con su node_id, su asunto y su URL propia para compartir con el cliente. Antes estos correos no tenían dirección: vivían enterrados en el flujo.
| Argument | Type | Description |
|---|---|---|
| flow_id* | string |
{
"type": "object",
"required": [
"flow_id"
],
"properties": {
"flow_id": {
"type": "string"
}
}
}Lista los formularios con sus KPIs. El número de cada formulario es primary_count en la unidad primary_unit: people = personas distintas (correo normalizado, sin papelera) en un formulario de captura; submissions = respuestas en una encuesta (is_survey true: una persona puede responder varias veces). people = personas distintas; submissions = envíos sin papelera (filas, repeticiones incluidas: NO es el número del formulario de captura); views = cargas del formulario (1 por navegador cada 24 h); views_measured false = la página que envía las altas no avisa de las visitas; conversion_rate = primary_count / views en % con 1 decimal (null si las vistas no están medidas). Los mismos números que la app.
| Argument | Type | Description |
|---|---|---|
| limit | number | 1-200, default 100. |
| is_active | boolean | true = solo activos · false = solo inactivos (opcional). |
{
"type": "object",
"properties": {
"limit": {
"type": "number",
"description": "1-200, default 100."
},
"is_active": {
"type": "boolean",
"description": "true = solo activos · false = solo inactivos (opcional)."
}
}
}Lista las páginas de aterrizaje con sus visitas, conversiones y tasa de conversión (conversion_rate = conversiones / visitas en % con 2 decimales y tope 100; null si aún no hubo visitas: no medible, no es 0 · cambio de contrato del 3-oct-2026, antes devolvía 0).
| Argument | Type | Description |
|---|---|---|
| limit | number |
{
"type": "object",
"properties": {
"limit": {
"type": "number"
}
}
}Lista los lanzamientos de la cuenta, con cuántas etapas tiene cada uno y cuántas ya están conectadas a un correo.
| Argument | Type | Description |
|---|---|---|
| limit | number | |
| status | string | planning | active | closed | archived. |
{
"type": "object",
"properties": {
"limit": {
"type": "number"
},
"status": {
"type": "string",
"description": "planning | active | closed | archived."
}
}
}Lista todas las listas de contactos con su tamaño: active_count = contactos ACTIVOS (a quienes les llega un envío) y total_count = todas las membresías (cualquier estado), de list_sizes_v1, la misma fuente que la app. Una lista inteligente se mide evaluando su filtro (hoy no se envía a listas inteligentes); size_ok false = no se pudo medir y los conteos vienen en null. contacts_count es un alias deprecado de total_count.
No arguments.
{
"type": "object",
"properties": {}
}Lista contactos paginados (más recientes primero, cursor keyset). Filtros: status (active|unsubscribed|bounced|complained), list_id (membresías físicas: una lista inteligente devuelve 0 filas; su tamaño está en list_lists (active_count / total_count) o en GET /api/v1/lists/{id}/count) y tag = nombre EXACTO de una etiqueta del catálogo (contact_tags, la misma fuente que /etiquetas). Desde el 3-oct-2026 tag ya no mira las etiquetas importadas (imported_tags): cada fila trae `tags` (importadas, como siempre) y `catalog_tags` (las del catálogo, las que filtra tag). include_count:true añade total_count; si el conteo no se puede hacer responde 503 count_unavailable, nunca 0.
| Argument | Type | Description |
|---|---|---|
| tag | string | Nombre exacto de una etiqueta del catálogo (contact_tags). |
| limit | number | 1-500 (default 100). |
| cursor | string | pagination.next_cursor de la página anterior. |
| status | string | |
| list_id | string | Solo miembros de esta lista. |
| include_count | boolean | true añade total_count (consulta aparte). |
{
"type": "object",
"properties": {
"tag": {
"type": "string",
"description": "Nombre exacto de una etiqueta del catálogo (contact_tags)."
},
"limit": {
"type": "number",
"description": "1-500 (default 100)."
},
"cursor": {
"type": "string",
"description": "pagination.next_cursor de la página anterior."
},
"status": {
"enum": [
"active",
"unsubscribed",
"bounced",
"complained"
],
"type": "string"
},
"list_id": {
"type": "string",
"description": "Solo miembros de esta lista."
},
"include_count": {
"type": "boolean",
"description": "true añade total_count (consulta aparte)."
}
}
}Devuelve a tus envíos a un contacto que salió por un rebote TEMPORAL suelto (buzón lleno, servidor ocupado). Solo funciona si el rebote fue temporal, el dominio no está bloqueado ni mal escrito (gmail.co, hormail.com: corrige la dirección; el 409 trae dominio_sugerido) y no se dio de baja ni marcó spam; si no, responde 409 con el motivo (por ejemplo, rebote definitivo: la dirección no existe). No reanuda flujos viejos ni envía la bienvenida. Úsalo en vez de update_subscriber con status "active".
| Argument | Type | Description |
|---|---|---|
| email* | string | Correo (o id) del contacto rebotado. |
{
"type": "object",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"description": "Correo (o id) del contacto rebotado."
}
}
}Envía un correo transaccional 1-a-1 (cotización, recibo, bienvenida, recordatorio) a UNA dirección, usando una plantilla y variables. Síncrono. Requiere scope `send`.
| Argument | Type | Description |
|---|---|---|
| subject | string | Asunto (opcional si la plantilla lo trae). |
| to_email* | string | Correo del destinatario. |
| from_name | string | Nombre del remitente (opcional). |
| html_body | string | HTML libre (opcional, alternativa a template_id). |
| variables | object | Variables mustache {{var}} para rellenar la plantilla. Ej: {"first_name":"María"}. |
| template_id | string | ID de la plantilla en Postari (opcional si mandas subject+html_body). |
| confirm_send | boolean | Obligatorio en true para enviar de verdad (acción sensible: además la cuenta debe tener habilitados los envíos por agente). Sin él no se envía nada. |
{
"type": "object",
"required": [
"to_email"
],
"properties": {
"subject": {
"type": "string",
"description": "Asunto (opcional si la plantilla lo trae)."
},
"to_email": {
"type": "string",
"description": "Correo del destinatario."
},
"from_name": {
"type": "string",
"description": "Nombre del remitente (opcional)."
},
"html_body": {
"type": "string",
"description": "HTML libre (opcional, alternativa a template_id)."
},
"variables": {
"type": "object",
"description": "Variables mustache {{var}} para rellenar la plantilla. Ej: {\"first_name\":\"María\"}.",
"additionalProperties": true
},
"template_id": {
"type": "string",
"description": "ID de la plantilla en Postari (opcional si mandas subject+html_body)."
},
"confirm_send": {
"type": "boolean",
"description": "Obligatorio en true para enviar de verdad (acción sensible: además la cuenta debe tener habilitados los envíos por agente). Sin él no se envía nada."
}
}
}Define A QUIÉN se le manda un correo y a quién NO: excluir por etiqueta, por lista entera o por haber recibido otra campaña. Devuelve el número REAL de destinatarios para confirmar antes de enviar. Si alguna referencia no existe, falla con 400 en vez de guardar a medias.
| Argument | Type | Description |
|---|---|---|
| campaign_id* | string | |
| exclude_tags | array | Fuera quien tenga estas etiquetas (nombre o UUID). |
| include_tags | array | Solo quien tenga estas etiquetas (nombre o UUID). |
| exclude_lists | array | Fuera los miembros de estas listas · "manda a A menos los de B". |
| tag_on_delivery | string | Etiqueta que se pone a quien RECIBA el correo, para poder excluirlo la próxima vez. |
| exclude_campaigns | array | Fuera quien ya recibió estas campañas · no repetir el envío. |
{
"type": "object",
"required": [
"campaign_id"
],
"properties": {
"campaign_id": {
"type": "string"
},
"exclude_tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Fuera quien tenga estas etiquetas (nombre o UUID)."
},
"include_tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Solo quien tenga estas etiquetas (nombre o UUID)."
},
"exclude_lists": {
"type": "array",
"items": {
"type": "string"
},
"description": "Fuera los miembros de estas listas · \"manda a A menos los de B\"."
},
"tag_on_delivery": {
"type": "string",
"description": "Etiqueta que se pone a quien RECIBA el correo, para poder excluirlo la próxima vez."
},
"exclude_campaigns": {
"type": "array",
"items": {
"type": "string"
},
"description": "Fuera quien ya recibió estas campañas · no repetir el envío."
}
}
}Añade o quita una etiqueta a varios contactos (por emails o contact_ids).
| Argument | Type | Description |
|---|---|---|
| tag* | string | Nombre de la etiqueta. |
| emails | array | |
| operation | string | add (default) o remove. |
| contact_ids | array |
{
"type": "object",
"required": [
"tag"
],
"properties": {
"tag": {
"type": "string",
"description": "Nombre de la etiqueta."
},
"emails": {
"type": "array",
"items": {
"type": "string"
}
},
"operation": {
"enum": [
"add",
"remove"
],
"type": "string",
"description": "add (default) o remove."
},
"contact_ids": {
"type": "array",
"items": {
"type": "string"
}
}
}
}Prueba una automatización enviándola de verdad a UN miembro de la cuenta (por defecto el dueño). Es OBLIGATORIO antes de armar. No se puede usar para mandar correo a terceros: to_email tiene que ser de un miembro.
| Argument | Type | Description |
|---|---|---|
| flow_id* | string | |
| to_email | string | Correo de un miembro de la cuenta. Por defecto, el dueño. |
{
"type": "object",
"required": [
"flow_id"
],
"properties": {
"flow_id": {
"type": "string"
},
"to_email": {
"type": "string",
"description": "Correo de un miembro de la cuenta. Por defecto, el dueño."
}
}
}Mete un contacto (por email o contact_id) en un flujo automático para que reciba esa secuencia.
| Argument | Type | Description |
|---|---|---|
| string | ||
| flow_id* | string | ID del flujo. |
| contact_id | string | |
| trigger_data | object |
{
"type": "object",
"required": [
"flow_id"
],
"properties": {
"email": {
"type": "string"
},
"flow_id": {
"type": "string",
"description": "ID del flujo."
},
"contact_id": {
"type": "string"
},
"trigger_data": {
"type": "object",
"additionalProperties": true
}
}
}Edita una automatización: nombre, disparador, pasos (graph) o estado. NO sirve para armar (eso es arm_flow, que exige confirmación); sí para DESARMAR con armed:false.
| Argument | Type | Description |
|---|---|---|
| name | string | |
| armed | boolean | Solo false (desarmar). Para armar usa arm_flow. |
| graph | object | |
| status | string | draft | active | paused. |
| flow_id* | string | |
| trigger_config | object |
{
"type": "object",
"required": [
"flow_id"
],
"properties": {
"name": {
"type": "string"
},
"armed": {
"type": "boolean",
"description": "Solo false (desarmar). Para armar usa arm_flow."
},
"graph": {
"type": "object",
"additionalProperties": true
},
"status": {
"type": "string",
"description": "draft | active | paused."
},
"flow_id": {
"type": "string"
},
"trigger_config": {
"type": "object",
"additionalProperties": true
}
}
}Edita UN correo de una automatización (asunto, preheader, bloques o etiqueta) sin tocar el resto del flujo. Más seguro que reescribir el graph entero.
| Argument | Type | Description |
|---|---|---|
| label | string | |
| blocks | array | Bloques del correo. |
| flow_id* | string | |
| node_id* | string | |
| subject | string | |
| preheader | string |
{
"type": "object",
"required": [
"flow_id",
"node_id"
],
"properties": {
"label": {
"type": "string"
},
"blocks": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"description": "Bloques del correo."
},
"flow_id": {
"type": "string"
},
"node_id": {
"type": "string"
},
"subject": {
"type": "string"
},
"preheader": {
"type": "string"
}
}
}Edita un formulario: título, campos, lista donde caen las altas, doble opt-in, mensaje de gracias o activarlo/desactivarlo.
| Argument | Type | Description |
|---|---|---|
| name | string | |
| fields | array | |
| form_id* | string | |
| list_id | string | |
| is_active | boolean | |
| double_optin | boolean | |
| redirect_url | string | |
| thank_you_message | string |
{
"type": "object",
"required": [
"form_id"
],
"properties": {
"name": {
"type": "string"
},
"fields": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"form_id": {
"type": "string"
},
"list_id": {
"type": "string"
},
"is_active": {
"type": "boolean"
},
"double_optin": {
"type": "boolean"
},
"redirect_url": {
"type": "string"
},
"thank_you_message": {
"type": "string"
}
}
}Edita una página de aterrizaje: contenido, slug, formulario conectado o activarla/desactivarla. Cambiar el slug rompe la URL que ya se haya compartido (la respuesta avisa).
| Argument | Type | Description |
|---|---|---|
| name | string | |
| slug | string | |
| blocks | array | |
| form_id | string | |
| ai_prompt | string | |
| html_code | string | |
| is_active | boolean | |
| landing_id* | string |
{
"type": "object",
"required": [
"landing_id"
],
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"blocks": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"form_id": {
"type": "string"
},
"ai_prompt": {
"type": "string"
},
"html_code": {
"type": "string"
},
"is_active": {
"type": "boolean"
},
"landing_id": {
"type": "string"
}
}
}Actualiza datos de un contacto existente (nombre, país, teléfono, etiquetas). Solo envía esos campos: no cambia su estado de suscripción. Para devolver a alguien que salió por un rebote usa reactivate_bounced_subscriber. Quien se dio de baja o marcó spam solo vuelve por decisión propia (centro de preferencias del pie de los correos); un agente no puede resuscribirlo: el PUT /api/v1/subscribers/{email} con confirmar_resuscripcion:true es solo para una persona con su llave, queda auditado y desde el puente MCP responde 403 resuscripcion_no_disponible_para_agentes.
| Argument | Type | Description |
|---|---|---|
| tags | array | |
| email* | string | |
| phone | string | |
| country | string | |
| last_name | string | |
| first_name | string |
{
"type": "object",
"required": [
"email"
],
"properties": {
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"email": {
"type": "string"
},
"phone": {
"type": "string"
},
"country": {
"type": "string"
},
"last_name": {
"type": "string"
},
"first_name": {
"type": "string"
}
}
}| cta_label |
| string |
| Texto del botón (opcional). |
| from_name | string | Nombre del remitente (opcional). |
| html_body | string | HTML libre (opcional · alternativa a brief/blocks). |
| variables | object | Variables mustache {{var}} (opcional). |
| confirm_send | boolean | false (default) = solo borrador + preview, no envía. true = ENVÍA de verdad a la lista (requiere scope send + que el tenant tenga habilitados los envíos por agente). |
| scheduled_at | string | ISO8601 para agendar el envío (opcional · requiere confirm_send). |
{
"type": "object",
"required": [
"list_id"
],
"properties": {
"goal": {
"type": "string",
"description": "Objetivo opcional: ventas, reactivación, anuncio, evento…"
},
"tone": {
"type": "string",
"description": "Tono opcional: cálido, urgente, divertido, profesional…"
},
"brief": {
"type": "string",
"description": "Qué comunicar, en lenguaje natural. Ej: \"Black Friday 30% OFF en todos los cursos, tono urgente, cierra el viernes\". Postari escribe el correo."
},
"blocks": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"description": "Bloques de contenido propios (opcional · alternativa a brief)."
},
"cta_url": {
"type": "string",
"description": "URL del botón principal (opcional)."
},
"list_id": {
"type": "string",
"description": "UUID de la lista destino (usa list_lists para verlas). Una lista inteligente no sirve para enviar: 409 smart_list_not_sendable."
},
"subject": {
"type": "string",
"description": "Asunto exacto (opcional · si lo das, no se genera)."
},
"cta_label": {
"type": "string",
"description": "Texto del botón (opcional)."
},
"from_name": {
"type": "string",
"description": "Nombre del remitente (opcional)."
},
"html_body": {
"type": "string",
"description": "HTML libre (opcional · alternativa a brief/blocks)."
},
"variables": {
"type": "object",
"description": "Variables mustache {{var}} (opcional).",
"additionalProperties": true
},
"confirm_send": {
"type": "boolean",
"description": "false (default) = solo borrador + preview, no envía. true = ENVÍA de verdad a la lista (requiere scope send + que el tenant tenga habilitados los envíos por agente)."
},
"scheduled_at": {
"type": "string",
"description": "ISO8601 para agendar el envío (opcional · requiere confirm_send)."
}
}
}