Integrations

API Keys & External Workflow Triggers

Any workflow with an API Trigger node can be invoked from outside Direnium. This is how you connect Direnium to your own systems, a form on your website, a cron job, a third-party webhook.

Creating an API key

  1. Go to Settings โ†’ API Keys and click Create.
  2. Give the key a name (the name is only for your reference).
  3. Copy the key, this is the only time you will see it. Direnium stores only a hash.

Each key is scoped to your organization. You can revoke it any time from the API Keys page.

Triggering a workflow

Build a workflow that starts with an API Trigger node, connect your action nodes, and publish. Then POST to the workflow's URL with your key in the Authorization header.

The endpoint is: POST https://api.direnium.com/api/v1/workflows/{workflowId}/trigger

Request:

  • Header: Authorization: Bearer dir_your_key
  • Body: { "payload": { ...your form fields } }

Response

You get back a jobId. The workflow runs asynchronously. Poll GET /api/v1/jobs/{jobId} for status if you need to know when it finishes.

Common uses

  • A contact form on your marketing site posts to a Direnium workflow that adds the lead to CRM.
  • A Zapier Zap calls Direnium when a Typeform is submitted.
  • An internal cron job triggers a weekly digest workflow.
Was this helpful?

Want to see it in action?

Tell us your use case ยท English or Hebrew ยท No signup needed

Talk to us