*API REST › Guías*

# Zapier, Make y n8n

> Zapier, Make y n8n pueden llamar a la API de Filmo con su paso HTTP genérico. Envía la clave como cabecera bearer, pagina las listas con el cursor, espera cuando recibas un 429 y da a cada escritura su propia clave de idempotencia.

## Antes de construir

- Crea una clave por escenario o Zap, solo con los scopes que necesita (consulta [Permisos (scopes)](https://docs.filmo.io/es/rest-api/guides/scopes)).
- Guarda la clave en el almacén de credenciales o de secretos de la plataforma. No la pegues en un campo del escenario que se muestre en los registros o se exporte con él.
- Haz tu primera llamada a [`GET /api/v1/account`](https://docs.filmo.io/es/rest-api/endpoint-reference/account/get-the-account) para confirmar que la clave funciona y ver sus scopes.

## Configurar el paso HTTP

En Zapier usa una acción de petición HTTP personalizada. En Make usa el módulo HTTP. En n8n usa el nodo HTTP Request. Los ajustes son los mismos en los tres.

| Ajuste | Valor |
| --- | --- |
| URL | `https://app.filmo.io/api/v1/...`, con la ruta de la operación |
| Método | El método de la operación (GET para leer, POST, PATCH o PUT para escribir) |
| Cabecera `Authorization` | `Bearer ` seguido de la clave, tomada del almacén de credenciales |
| Cabecera `Accept` | `application/json` |
| Cabecera `Content-Type` | `application/json` en las escrituras |
| Cuerpo | JSON. Las fechas son ISO 8601 con desplazamiento, como `2026-10-17T09:00:00+02:00` |
| Cabecera `Idempotency-Key` | En cada escritura; ver más abajo |

Haz que el paso entregue las respuestas 4xx y 5xx a tu escenario en lugar de fallar en silencio, para poder leer el estado, el `code` del error y `Retry-After`. Bifurca según `code`, nunca según `detail`.

## Paginar las listas

1. **Pide la primera página** Envía la petición de lista con un `limit` (el máximo es 500).
2. **Comprobar si hay más** Lee `pagination.hasMore` en la respuesta.
3. **Pide la página siguiente** Mientras sea `true`, repite la petición con `cursor` igual a `pagination.nextCursor` y el mismo `limit`.

Trata el cursor como opaco. Zapier no tiene un bucle de cursor integrado, así que haz el bucle en un paso de código o con sus herramientas de bucle. Make y n8n tienen iteradores y bucles, y el nodo HTTP Request de n8n tiene una opción de paginación. Pon siempre un número máximo de páginas en el bucle. Consulta [Paginación](https://docs.filmo.io/es/rest-api/guides/pagination) para ver los detalles, y [Sincronizar datos](https://docs.filmo.io/es/rest-api/guides/syncing-data) para saber cómo leer solo lo que cambió.

## Gestionar 429 y Retry-After

Cada clave tiene 120 peticiones por minuto, y las consultas de disponibilidad tienen 30 por minuto aparte. Todos los escenarios que comparten una clave comparten esa cuota, y cada paso HTTP dentro de un bucle es una petición. Cuando se supera un límite, la respuesta es 429 [`rate_limited`](https://docs.filmo.io/es/rest-api/errors/rate_limited) con una cabecera `Retry-After` en segundos. Espera ese tiempo y reintenta la misma petición con la misma clave de idempotencia. Frena los bucles a propósito y usa una clave por escenario para que una ejecución no deje sin cuota a otra. Consulta [Límites de peticiones](https://docs.filmo.io/es/rest-api/guides/rate-limits).

## Una Idempotency-Key por registro

Las plataformas reintentan pasos y te permiten volver a ejecutar una ejecución fallida. Sin clave, cada reintento puede crear el registro otra vez. Envía un `Idempotency-Key` en cada escritura, construido con algo que se mantenga igual para ese registro: el id del registro en el sistema de origen más lo que haces con él (por ejemplo `crm-4821-create-contact`). Usa una clave distinta para cada registro, nunca una para toda la ejecución. Si vuelves a ejecutar una ejecución tras cambiar los datos, la misma clave con un cuerpo distinto es un 422 [`idempotency_key_reused`](https://docs.filmo.io/es/rest-api/errors/idempotency_key_reused), que es la señal para usar una clave nueva. Las claves duran 24 horas. Consulta [Idempotencia](https://docs.filmo.io/es/rest-api/guides/idempotency).

Envía siempre tu propia clave a [`POST /api/v1/orders/line-items/returns`](https://docs.filmo.io/es/rest-api/endpoint-reference/orders/return-order-lines), [`POST /api/v1/purchase-orders/{purchaseOrderId}/receive`](https://docs.filmo.io/es/rest-api/endpoint-reference/purchase-orders/receive-material-from-a-purchase-order), [`POST /api/v1/treasury/payments`](https://docs.filmo.io/es/rest-api/endpoint-reference/treasury/record-an-incoming-or-outgoing-payment) y [`POST /api/v1/workflows/{workflowId}/runs`](https://docs.filmo.io/es/rest-api/endpoint-reference/workflows/run-a-workflow). Un reintento sin ella duplica algo que no se puede deshacer.

## Recibir cambios de Filmo

Filmo no envía webhooks, pero un workflow de Filmo puede enviar una petición HTTP a una URL cuando ocurre un evento, y Zapier, Make y n8n ofrecen cada uno un trigger que recibe una llamada HTTP entrante. Crea el trigger en la plataforma, copia su URL en el paso de petición HTTP de un workflow de Filmo y pon un secreto en una cabecera de ese paso. El paso no tiene firma. El paso no reintenta, pero la ejecución se intenta hasta tres veces, así que deduplica por la cabecera `Idempotency-Key` y mantén una lectura programada como fuente de verdad. La petición, sus límites y los campos del evento se describen en [Sincronizar datos](https://docs.filmo.io/es/rest-api/guides/syncing-data).

## Evita los bucles

> **Un escenario puede disparar el workflow que lo llamó:** Una escritura de tu escenario dispara los workflows de eventos de la cuenta, y no puedes suprimirlo por petición. Si uno de esos workflows llama de vuelta a tu escenario, los dos se alimentan mutuamente sin fin. La protección de cadenas de Filmo no lo detecta cuando el escenario escribe con una clave de API, porque esa escritura llega como un evento nuevo de origen `api`. Filtra el trigger de cada workflow por `origin` para excluir `api`.

- Ejecuta el escenario con una programación y lee qué ha cambiado, además de esperar una llamada o en lugar de hacerlo.
- Antes de escribir, compara con el valor actual y omite la escritura cuando no cambie nada.
- Marca lo que escribió la integración, por ejemplo con una etiqueta, y haz que el escenario ignore los registros que lleven esa marca.
- Fija un tope de ejecuciones por hora en la plataforma, para que un bucle se detenga solo.
- Revisa los workflows activos de la cuenta antes de activar el escenario (consulta [Pruebas](https://docs.filmo.io/es/rest-api/guides/testing)).

## La primera ejecución es la peligrosa

La primera ejecución de un escenario suele abarcar todo el historial. Leer miles de registros lleva minutos a 120 peticiones por minuto, y cada petición cuenta como una tarea u operación en la mayoría de las plataformas, así que revisa tu plan. Si la primera ejecución escribe en Filmo, cada escritura puede iniciar las automatizaciones de la cuenta, incluidas las que envían emails a los clientes. Pausa antes esas automatizaciones, haz la primera carga con un lote pequeño y solo después ábrela del todo.

## Agentes de IA en Make y n8n

Make y n8n también tienen nodos que se conectan a servidores MCP, que permiten a un paso de IA elegir por sí mismo las herramientas de Filmo. El servidor está en `https://app.filmo.io/api/v1/mcp`. Empieza por la [Resumen de MCP](https://docs.filmo.io/es/mcp/overview), luego los pasos para conectar [Make](https://docs.filmo.io/es/mcp/connect/make) o [n8n](https://docs.filmo.io/es/mcp/connect/n8n). Para flujos fijos y predecibles, prefiere los pasos HTTP descritos aquí.

---

URL canónica: https://docs.filmo.io/es/rest-api/guides/no-code-platforms  
Última actualización: 2026-10-09