Create the webhook
1
Create it
Select Create webhook. Conduit creates the endpoint and a secret.
2
Copy the secret
Copy the secret marked Visible once and store it somewhere safe. Conduit only shows the full secret once. Afterward, you see only its last characters.
3
Copy the endpoint
Copy the URL under Endpoint. This is where the other system sends its requests.
4
Write the agent task
Edit Agent task. Conduit passes it to the agent on every webhook run, alongside the payload. Then select Save.
Send a request
Send aPOST request with a JSON body to the endpoint. Authenticate with the secret as a bearer token.
Headers
Body
The body must be valid JSON, up to 1 MB. An empty body is treated as an empty object.Retries and duplicates
Send the same idempotency key when you retry a request. While a run for that key is queued, running or completed, Conduit returns202 with "duplicate": true and doesn’t start another one. If the earlier run failed, a retry with the same key starts a new run, so design your task to be safe to repeat. Without an idempotency key, every request starts a new run.
Responses
Conduit responds as soon as the run is queued. It doesn’t wait for the agent to finish.
Error responses include an
error message, for example:
Manage the webhook
Each agent has one webhook. To test it without an external system, use Run now > Webhook and paste a sample body. See Run now with a mocked trigger.
This webhook starts an internal agent. To start a workflow from an external system instead, use a workflow’s webhook trigger. An internal agent can react to those too, through the Workflow webhook received platform event.