Skip to main content

Send Webhook Action

The Send Webhook action sends HTTP requests to external systems. Use this to integrate with third-party services, APIs, or your own systems.

Jerome Bajou avatar
Written by Jerome Bajou
Updated over a month ago

Overview

The Send Webhook action sends HTTP requests to external systems. Use this to integrate with third-party services, APIs, or your own systems.

Supported Methods

  • GET

  • POST

  • PUT

  • PATCH

  • DELETE

  • HEAD

  • OPTIONS


Configuration

Method (Required)

HTTP method to use. Default: POST

URL (Required)

Target URL for the webhook. Supports variables.

Examples:

<https://api.example.com/webhook> {external_system.webhook_url}

Headers (Optional)

Custom HTTP headers. Format: key-value pairs.

Examples:

Authorization: Bearer {api_token} Content-Type: application/json X-Custom-Header: {value}

Content Type (Optional)

Content type for the request body. Default: application/json

Common types:

  • application/json

  • application/xml

  • text/plain

  • application/x-www-form-urlencoded

Body (Optional)

Request body content. Required for POST, PUT, PATCH. Supports variables and JSON.

JSON Example:

{
"booking_id": "{booking.id}",
"customer": {
"name": "{customer.name}",
"email": "{customer.email}"
},
"amount": "{booking.gross_price}"
}

Output

Returns response data:

  • status - HTTP status code

  • body - Response body

  • headers - Response headers

  • success - Boolean indicating success (2xx status)


Examples

1. Send to External API

Method: POST 
URL: <https://api.example.com/bookings>
Headers: Authorization: Bearer {api_token}
Body: {
"id": "{booking.id}",
"customer": "{customer.name}"
}

2. Update CRM System

Method: PUT 
URL: {crm.webhook_url}/customers/{customer.id}
Body: {
"email": "{customer.email}",
"phone": "{customer.phone}"
}

3. Delete Record

Method: DELETE 
URL: <https://api.example.com/bookings/{booking.id}>

Best Practices

  1. Use HTTPS - Always use secure URLs

  2. Authenticate - Include API keys in headers

  3. Handle errors - Check response status

  4. Validate data - Ensure required fields exist

  5. Test endpoints - Verify webhook URLs work

  6. Log responses - Review execution logs for debugging


Error Handling

  • Failed requests are logged in execution logs

  • Check success field in output

  • Set up failure notifications for critical webhooks

  • Retry logic may be needed for unreliable endpoints


Related Documentation

Did this answer your question?