This guide walks you through creating a Swimlane Turbine playbook with a webhook trigger, and gathering the configuration needed to create a Swimlane Turbine Sink integration.
In Swimlane Turbine, a webhook is not a standalone resource — it is a trigger that lives inside a playbook. You will first create a playbook, then add a Catch Webhook trigger to it, and configure the webhook URL and authentication from within that trigger.
Log in to your Swimlane Turbine instance. If your organization uses multiple tenants, select the appropriate tenant after logging in.
In the left-side navigation, click ORCHESTRATION, then click Playbooks. From the Playbooks home page task bar, click the + (plus menu) icon and select Create a new playbook. Enter a descriptive name for the playbook (for example, "Synqly Sink") and click Save. The playbook canvas opens.
In the Add panel on the left side of the canvas, find the Catch Webhook trigger and drag it onto the canvas. The trigger configuration panel opens on the right side of the canvas.
In the trigger panel, click Edit Webhook to open the webhook settings. In the Settings tab, copy the Webhook URL and save it to a safe location. This is the endpoint Synqly will send events to.
Note: If the URL has not yet been generated, look for a Generate URL button and click it first.
Still in the Edit Webhook settings, click Add a property and expand the Authentication section. Then expand Shared Secret Authentication and configure the following fields:
- Secret: Enter a strong, unique secret string of your choice. Copy this value and store it securely — it will be used as the Bearer token when creating the Synqly integration.
- Secret Format:
plaintext - Secret Location: Select Request Header, then set:
- Header Name:
Authorization
- Header Name:
Leave the auth scheme at its default value of Bearer. Click Save (or Save and Close) to apply the settings.
Back in the trigger panel, ensure the Enabled toggle is turned on. Then return to the playbook canvas and publish the playbook so that the webhook can receive incoming events.
Note: For more detail on creating playbooks and configuring webhooks, see How to Create a Playbook and Using Webhook Triggers in Swimlane Turbine in the Swimlane documentation.
Create your integration by supplying all of the required configuration values.
Webhook URL
This is the webhook trigger URL copied in step 4. The URL must use HTTPS.
Bearer Token
This is the secret value you configured in step 5. Synqly will include this token in the Authorization: Bearer <token> header on every request sent to your webhook.