ConverterHQDevelopers
API v1

Zapier

Automatiza conversiones con acciones y triggers oficiales de Zapier.

La app de Zapier usa OAuth y los mismos contratos REST, de capacidades y webhooks que una integración propia.

Autenticación

Conecta la cuenta mediante OAuth de HQTools. Los grants tienen scopes y son revocables; la acción de conversión incluye File write porque una conversión simple crea primero un File de entrada propio.

Acciones

Convierte Files, crea y gestiona Jobs, ejecuta Workflows, estima conversiones y crea URLs firmadas. Los campos dinámicos proceden del grafo de capabilities.

Triggers instantáneos

Éxitos y fallos de Job/conversión llegan por el sistema durable de webhooks. La entrega es al menos una vez; deduplica efectos sensibles.

Datos de Workflow

Run Workflow acepta variables validadas, metadata y client_reference_id. Asigna el identificador estable del evento de origen a business_event_id. ConverterHQ convierte esa identidad en la clave de idempotencia, de modo que un reintento de transporte reutiliza el run previsto y un evento posterior crea trabajo nuevo.

Operar un Zap

Convert a File vuelve a intentar una conversión que sigue procesándose con la misma identidad business_event_id en vez de entregar un resultado incompleto al siguiente paso. Para flujos largos y fan-out, el trigger webhook de finalización es el límite preferido antes de los pasos posteriores.