Triggers

Webhook

Triggers when a webhook receives a POST or GET request with structured data.

Category: Triggers · Plans: Trial, Starter, Pro, Premium, Enterprise · Type: WebhookTrigger · Trigger

Inputs#

FieldTypeRequiredDefaultWhat it does
Webhook URLwebhook_trigger_urlNo(empty)The unique URL for this webhook trigger. Copy and use it in external services.
Allowed MethodTextNoPOSTHTTP method this webhook accepts. Requests with other methods return 405. Options: POST, GET
Validate Body SchemaYes/NoNoOffWhen enabled, request body must match the JSON Schema defined below.
JSON SchemaTextNo—JSON Schema definition for request body validation. Only used when ‘Validate Body Schema’ is enabled.

%!s()#

JSON Schema for Webhook Body Validation#

For full documentation, see the JSON Schema Reference.

Basic Object Schema#

Validate that the body is an object with specific properties:

json
{
  "type": "object",
  "properties": {
    "name": {"type": "string"},
    "age": {"type": "integer"}
  },
  "required": ["name"]
}

String with Constraints#

json
{
  "type": "object",
  "properties": {
    "email": {"type": "string", "format": "email"},
    "code": {"type": "string", "minLength": 3, "maxLength": 10}
  }
}

Enum Values#

Restrict a field to specific values:

json
{
  "type": "object",
  "properties": {
    "status": {"type": "string", "enum": ["active", "inactive", "pending"]}
  }
}

Nested Objects#

json
{
  "type": "object",
  "properties": {
    "user": {
      "type": "object",
      "properties": {
        "name": {"type": "string"},
        "address": {
          "type": "object",
          "properties": {
            "city": {"type": "string"},
            "zip": {"type": "string"}
          }
        }
      }
    }
  }
}

Arrays#

json
{
  "type": "object",
  "properties": {
    "tags": {
      "type": "array",
      "items": {"type": "string"},
      "minItems": 1
    }
  }
}

Supported Types#

  • string – text values (supports format: email, uri, date-time, etc.)
  • integer – whole numbers
  • number – any numeric value
  • boolean – true or false
  • array – list of items
  • object – nested key-value pairs
  • null – null value

Empty Schema#

Leave empty to accept any request body without validation.

Outputs#

OutputType
DataAny
MethodAny
HeadersAny
Query ParamsAny