Relay.app Docs
  • Getting Started
    • Introduction
    • Helpful Resources
    • FAQ
  • Triggers
    • Triggers 101
    • Webhook Trigger
    • Mailhook Trigger
    • Manual Trigger
    • Scheduled Trigger
    • Batch Triggers
    • RSS Trigger
  • Actions in Apps
    • App Actions 101
  • Creating Templated Documents
  • DATA
    • Step Outputs
    • Find Steps
    • Lists (Arrays)
    • Inspecting Run Data
  • AI
    • AI Steps
    • Human-in-the-Loop AI reviews
    • AI Credits
    • Agentic Tool Use
    • Knowledge
    • Prompt Templates
    • Prompt Tips
    • Audio Transcription
  • Built-in actions
    • Transform Data
    • Create Constants
    • Search Google
    • Scrape Text from Website
    • Custom HTTP Requests
    • Run Custom Code (JS)
  • Flow Control
    • Paths
    • Iterators
    • Wait steps
    • Sequences
  • Human-in-the-Loop
    • Human-in-the-Loop Steps
    • AI output reviews
    • Roles
  • Workflows
    • Folders and Organization
    • Sharing Workflows
    • Headings
    • Notes
  • TEMPLATES
    • About Workflow Templates
    • Using a Template (Importing)
    • Creating a Template (Exporting)
  • Workspace
    • Step & AI credit usage
    • Billing and Plans
    • Workspace administration
    • (Sharing) App Accounts
  • App-Specific FAQs
    • Airtable
    • Attio
    • Cal.com
    • Coda
    • DeepSeek
    • Discord
    • Fireflies
    • Google AI Studio (Gemini)
    • Gmail
    • Google Docs
    • Google Drive
    • Google Sheets
    • Microsoft Permissions
    • Microsoft Outlook Mail
    • Notion
    • OpenAI
    • OpenPhone
    • Slack
    • X (Twitter)
    • QuickBooks Online
Powered by GitBook
On this page

Was this helpful?

  1. Triggers

Webhook Trigger

Last updated 5 days ago

Was this helpful?

Setting up a Webhook trigger

To get started, watch the video below and .

How do I apply run deduplication?

By including a relayDeduplicationKey property in your webhook's payload, you can enforce Relay.app to only trigger a run once for every unique case of relayDeduplicationKey.

Meaning:

  • The first time a unique value of relayDeduplicationKey is present that was never seen before, Relay.app will trigger a run for the webhook request

  • For all webhook requests afterwards where the value of relayDeduplicationKey is the same, no runs will be triggered and instead the following response is returned for the request:

{
  "status": "duplicate",
  "existingRunId": "<ID of previously triggered run>"
}
How do I send a custom response to the webhook request?

To return a custom payload to the caller:

  1. Add a Respond to webhook step anywhere in your workflow.

  2. Open the step and configure the body, headers, and status code that you want to send back.

When Relay receives the webhook request it waits up to 30 seconds for the Respond to webhook step to run. If the step hasn't executed within that window, Relay returns its default response instead.

Looking for making custom HTTP requests? .

Learn more here
read this tutorial