Zapier, Make and n8n
Triggers
Triggers are based on webhooks: when a workflow is activated, the platform registers a webhook endpoint with DebtFlow; when it is deactivated, the platform removes it. Events therefore arrive immediately, without polling every minute.
| Trigger | Event |
|---|---|
| New contact | contact.created |
| Invoice finalised | invoice.finalized |
| Invoice paid | invoice.paid |
| Invoice overdue | invoice.overdue |
| Quote accepted | offer.accepted |
| Payment received for a debt | payment.received |
| Debt moves to another phase | debt.phase_changed |
| Debt overdue | debt.overdue |
| Instalment falls due (3 days before) | installment.due |
| Instalment missed | installment.missed |
| Communication recorded | communication.created |
| Residents’ registration office request placed | residence_registry_inquiry.created |
| Creditor AI recommendation created | recommendation.created |
| Receipt recognised | receipt.processed |
| Letter delivered | letter.delivered |
| Any event | all events in the catalogue |
Actions
| Action | Endpoint |
|---|---|
| Create contact | POST /contacts |
| Find contact | GET /contacts |
| Create draft invoice | POST /invoices |
| Finalise invoice | POST /invoices/{id}/finalize |
| Send invoice | POST /invoices/{id}/send |
| Create debt | POST /debts |
| Record time | POST /time-entries |
| Log communication | POST /contacts/{id}/communications |
| Order residents’ registration office request (charged) | POST /contacts/{id}/residence-registry-inquiries |
| Generate creditor AI recommendation | POST /debts/{id}/recommendations |
| Add activity log entry | POST /activities |
| API request (any endpoint) | any endpoint of API v1 |
A residents’ registration office request (Melderegisteranfrage) costs €19.99 plus VAT per request and requires the scope research:write. The creditor AI (scope ai:write) uses your account’s AI quota; once the quota is used up, the API responds with 429. Only grant these scopes to a connection if the workflow really needs them.
Authentication
- Zapier and Make connect via OAuth 2.0: you sign in to DebtFlow and allow access. You can see and remove the connection under Settings → Apps.
- n8n supports both: an API key (simple, ideal for self-hosted instances) or OAuth 2.0.
Already possible today: without an official app
Sending data to DebtFlow
In Zapier (“Webhooks by Zapier”, action Custom Request), Make (module HTTP → Make a request) or n8n (node HTTP Request), send a request to https://www.debt-flow.io/api/v1/… with the header Authorization: Bearer df_live_… and a JSON body. The fields each endpoint expects are listed in the API reference. For POST requests, set an Idempotency-Key derived from a unique ID of the workflow run, so that retries by the platform do not create duplicates.
Receiving events from DebtFlow
On the platform, create a webhook trigger (Zapier “Catch Hook”, Make “Custom webhook”, n8n “Webhook”), copy its URL and add it in DebtFlow under Settings → Webhooks as an endpoint with the events you want. Verifying the signature is optional but recommended.