{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Swimlane Turbine Sink Configuration Guide","siteUrl":"https://docs.synqly.com","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Catch Webhook"]}," trigger to it, and configure the webhook URL and authentication from within that trigger."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create-a-playbook-with-a-webhook-trigger","__idx":0},"children":["Create a playbook with a webhook trigger"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"1-log-in-to-swimlane-turbine","__idx":1},"children":["1. Log in to Swimlane Turbine"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Log in to your Swimlane Turbine instance. If your organization uses multiple tenants, select the appropriate tenant after logging in."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"2-create-a-new-playbook","__idx":2},"children":["2. Create a new playbook"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the left-side navigation, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ORCHESTRATION"]},", then click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Playbooks"]},". From the Playbooks home page task bar, click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+"]}," (plus menu) icon and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create a new playbook"]},". Enter a descriptive name for the playbook (for example, \"Synqly Sink\") and click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},". The playbook canvas opens."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"3-add-a-catch-webhook-trigger","__idx":3},"children":["3. Add a Catch Webhook trigger"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add"]}," panel on the left side of the canvas, find the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Catch Webhook"]}," trigger and drag it onto the canvas. The trigger configuration panel opens on the right side of the canvas."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"4-generate-the-webhook-url","__idx":4},"children":["4. Generate the webhook URL"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the trigger panel, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Edit Webhook"]}," to open the webhook settings. In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings"]}," tab, copy the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Webhook URL"]}," and save it to a safe location. This is the endpoint Synqly will send events to."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Note: If the URL has not yet been generated, look for a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Generate URL"]}," button and click it first."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"5-configure-shared-secret-authentication","__idx":5},"children":["5. Configure shared secret authentication"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Still in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Edit Webhook"]}," settings, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add a property"]}," and expand the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authentication"]}," section. Then expand ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Shared Secret Authentication"]}," and configure the following fields:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Secret Format:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["plaintext"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Secret Location:"]}," Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Request Header"]},", then set:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Header Name:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Leave the auth scheme at its default value of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Bearer"]},". Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]}," (or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save and Close"]},") to apply the settings."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"6-enable-the-webhook-and-publish-the-playbook","__idx":6},"children":["6. Enable the webhook and publish the playbook"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Back in the trigger panel, ensure the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Enabled"]}," toggle is turned on. Then return to the playbook canvas and publish the playbook so that the webhook can receive incoming events."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Note: For more detail on creating playbooks and configuring webhooks, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.swimlane.com/how-to-create-a-playbook"},"children":["How to Create a Playbook"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.swimlane.com/using-webhook-triggers-in-swimlane-turbine"},"children":["Using Webhook Triggers in Swimlane Turbine"]}," in the Swimlane documentation."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"configure-the-integration","__idx":7},"children":["Configure the Integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create your integration by supplying all of the required configuration values."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Webhook URL"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This is the webhook trigger URL copied in step 4. The URL must use HTTPS."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Bearer Token"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This is the secret value you configured in step 5. Synqly will include this token in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization: Bearer <token>"]}," header on every request sent to your webhook."]}]},"headings":[{"value":"Create a playbook with a webhook trigger","id":"create-a-playbook-with-a-webhook-trigger","depth":2},{"value":"1. Log in to Swimlane Turbine","id":"1-log-in-to-swimlane-turbine","depth":3},{"value":"2. Create a new playbook","id":"2-create-a-new-playbook","depth":3},{"value":"3. Add a Catch Webhook trigger","id":"3-add-a-catch-webhook-trigger","depth":3},{"value":"4. Generate the webhook URL","id":"4-generate-the-webhook-url","depth":3},{"value":"5. Configure shared secret authentication","id":"5-configure-shared-secret-authentication","depth":3},{"value":"6. Enable the webhook and publish the playbook","id":"6-enable-the-webhook-and-publish-the-playbook","depth":3},{"value":"Configure the Integration","id":"configure-the-integration","depth":2}],"frontmatter":{"slug":"guides/provider-configuration/swimlane-turbine-sink-setup","seo":{"title":"Swimlane Turbine Sink Configuration Guide"}},"lastModified":"2026-05-07T14:59:24.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/provider-configuration/swimlane-turbine-sink-setup","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}