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.