ConverterHQDevelopers
API v1

Zapier

Automatiseer conversies met officiële Zapier-actions en triggers.

De ConverterHQ Zapier-app gebruikt OAuth en dezelfde REST-, capability- en webhookcontracten als eigen integraties.

Authenticatie

Verbind via HQTools OAuth. Grants zijn scoped en revokeable; de conversieactie bevat File write omdat een eenvoudige conversie eerst een owned input File maakt.

Actions

Converteer Files, maak/beheer Jobs, run Workflows, schat conversies en maak signed URLs. Dynamische velden komen uit de capability graph.

Instant triggers

Job-/conversiesucces en -falen worden door duurzame webhooks geleverd. Delivery is at-least-once; dedupliceer gevoelige side effects.

Workflowdata

Run Workflow accepteert gevalideerde variabelen, metadata en client_reference_id. Map de stabiele bron-event-ID naar business_event_id. ConverterHQ hasht die bedrijfsidentiteit naar de idempotency key, zodat een transportretry dezelfde run hergebruikt en een later event nieuw werk maakt.

Een Zap beheren

Convert a File probeert een nog lopende conversie opnieuw met dezelfde business_event_id-identiteit in plaats van een onvoltooid resultaat naar de volgende stap te sturen. Voor lange fan-out-workflows is de completion-webhooktrigger de voorkeursgrens vóór downstream-stappen.