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 yesterday

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?