Actualizar broadcast en Kit, con una API
Actualiza un broadcast en borrador o programado. Envía subject y content en cada actualización, copiados de List broadcasts cuando no cambian. Definir send_at programa el envío, y null devuelve el broadcast a borrador.
- Identificador
- kit_update_broadcast
La llamada
POST https://connect.reportei.com/api/tools/kit_update_broadcast/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"id": 1,
"subject": "<subject>",
"content": "<content>"
}
}Tu sistema envía el id de la conexión de tu cliente y los argumentos de la tool. Los headers son los mismos de toda la API de Connect: el token de tu producto y el token de tu cliente.
Parámetros
Las descripciones de los parámetros siguen la documentación oficial de la app, en inglés.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| id | integer | Sí | ID of the broadcast, from List broadcasts. |
| subject | string | Sí | Subject line of the email. |
| content | string | Sí | Body of the email as HTML. On a Classic template, the template adds its design around this body. |
| preview_text | string | No | Preview text shown after the subject in the inbox. |
| description | string | No | Internal description of the broadcast, not shown to the subscribers. |
| send_at | string | No | When to send, in ISO 8601, for example 2026-11-02T13:00:00-03:00. Without a time zone it is UTC. It schedules the sending; null takes the broadcast back to draft. |
| email_address | string | No | Sending address of the account to send from. |
| email_template_id | integer | No | ID of the email template, as the email_template id of a broadcast in List broadcasts. Starting point templates do not work. |
| public | boolean | No | true also publishes the broadcast on the web, in the newsletter feed of the Creator Profile and landing pages. |
| subscriber_filter | array | No | Who receives the broadcast: one object with exactly one of all, any or none. Without it, every subscriber receives it. |
Conexiones posibles
Tu cliente conecta su cuenta de Kit una sola vez, con uno de los modos de abajo. La misma conexión sirve para todas las tools del toolkit.
OAuth con la app de tu producto
Registras la app OAuth de tu producto una sola vez, con POST /api/merchants/credentials/kit, y tu cliente autoriza la cuenta en una pantalla de consentimiento. Connect renueva el token cuando está por vencer.
La respuesta
Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app. Los errores HTTP devueltos por la app usan el objeto {error, api_error}; la autenticación o validación pueden fallar antes de la ejecución. El header X-Toolkit-Execution-Id identifica la ejecución registrada, disponible en GET /api/tools/executions/{uuid}.
Lista para agentes de IA
El input de esta tool es un JSON Schema, disponible en GET /api/tools/kit_update_broadcast. Se convierte en la definición de tool de tu agente sin conversión.
Otras tools de Kit
- Listar suscriptoresGETLista los suscriptores con id, email, nombre, estado y campos personalizados, solo los activos por defecto. Busca uno por email_address. La respuesta trae subscribers y pagination; mientras has_next_page sea true, envía pagination.end_cursor como after.
- Crear suscriptorPOSTCrea un suscriptor activo. Cuando el email ya pertenece a un suscriptor, actualiza el nombre de ese suscriptor en su lugar. No añade ninguna tag: usa Apply tag a continuación.
- Actualizar suscriptorPUTActualiza el email, el nombre o los campos personalizados de un suscriptor. Una clave de campo personalizado que no existe en la cuenta hace fallar la solicitud.
- Listar tagsGETLista las tags con id, nombre y fecha de creación. La respuesta trae tags y pagination; mientras has_next_page sea true, envía pagination.end_cursor como after.
- Crear tagPOSTCrea una tag y la devuelve con su id. Cuando ya existe una tag con el mismo nombre, sin distinguir mayúsculas, devuelve esa tag en lugar de una duplicada.
- Aplicar tagPOSTAplica una tag a un suscriptor existente, encontrado por email. Las automatizaciones de la cuenta que empiezan con esa tag se ejecutan para el suscriptor. Crea antes el suscriptor con Create subscriber.
- Listar formulariosGETLista los formularios y landing pages con id, nombre, tipo y URL de inserción, solo los activos por defecto. La respuesta trae forms y pagination; mientras has_next_page sea true, envía pagination.end_cursor como after.
- Listar segmentosGETLista los segmentos con id y nombre. Los segmentos se crean en la app de Kit, y sus ids definen el público de un broadcast en subscriber_filter. La respuesta trae segments y pagination; mientras has_next_page sea true, envía pagination.end_cursor como after.
Toolkits de la misma categoría
AWeber12 tools
beehiiv12 tools
Brevo12 tools
Constant Contact12 tools
GetResponse13 tools
Mailjet15 tools
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
