Generic Webhook

Generic webhook connector — send HTTP requests to any URL with configurable method, headers, and payload.

Overview

Property	Value
Type	`webhook`
Authentication	`none`
Category	Generic

Configuration

Field	Type	Required	Description
`base_url`	string	No	Optional base URL (endpoints can use full URLs instead)
`auth_header`	string	No	Authorization header value (optional)

Available actions

Send JSON

Send a JSON payload via HTTP POST to any URL.


Endpoint	`POST {url}`
Method	`POST`

Send Form Data

Send form-encoded data via HTTP POST to any URL (application/x-www-form-urlencoded).


Endpoint	`POST {url}`
Method	`POST`

Send GET Request

Send a GET request to any URL, optionally with query parameters.


Endpoint	`GET {url}`
Method	`GET`

Example flow

flow: shopify-order-to-partner-api
version: 1
description: Receive a Shopify order webhook, transform the payload, and send JSON to partner API

source:
  connector: shopify-prod
  trigger: webhook
  event: order.created

steps:
  - name: transform-order
    transform:
      partner_order_id: source.name
      customer:
        name: source.customer.first_name + " " + source.customer.last_name
        email: source.customer.email
        phone: source.customer.phone | default("")
      items: source.line_items
      shipping:
        address: source.shipping_address.address1
        city: source.shipping_address.city
        zip: source.shipping_address.zip
        country: source.shipping_address.country_code
      total: source.total_price | decimal(2)
      currency: source.currency | uppercase

  - name: send-to-partner
    target: generic-webhook-partner
    action: send-json
    mapping:
      url: "https://api.partner.com/v2/orders"
      headers:
        X-API-Key: "{{ secrets.PARTNER_API_KEY }}"
        X-Idempotency-Key: source.id | string
      body: transform
    store_as: partner_response

  - name: update-order-note
    target: shopify-prod
    action: update-order
    mapping:
      orderId: source.id
      note: "Sent to partner API — ref: {{ partner_response.reference_id }}"

on_error:
  retry: 3x exponential(30s)
  then: dead-letter