HTTP Webhook trigger event

Webhooks are automated messages that send content—or "payloads"—to a unique URL. With the HTTP Webhook trigger event, you can automatically start a chain when a webhook URL receives an HTTP POST request with a JSON payload. You can then use the JSON payload as a Data output with the chain's commands, such as to insert into a spreadsheet.

Requirements

• The HTTP Request connector must be set up before using this trigger event.
  
  

Start the chain with the trigger event

When you add the trigger event to a chain, it automatically generates the webhook URL to receive JSON payloads.

1. Go to Chain Builder, and select the chain you'd like to work with.
2. Search for Trigger Event play_for_work from the menu on the left, and drag the HTTP Webhook play_for_work command to the Start position on the canvas.
   
   
3. Select the HTTP Webhook node, and click Edit  create.
4. Under Basic Info, enter a unique name and description to help identify the event.
   
5. Under Trigger Event Details, select the HTTP Request connector and CloudRunner to use with the event.
6. Enter the bearer token to use to secure the webhook URL.

   Note: Think of the bearer token as a password. Create a token that is difficult to guess, and save it securely.

7. Click Save.

Call the webhook with an HTTP POST request

For the trigger event to start the chain, the HTTP POST request must include:

• The webhook URL
• The content-type; for instance, application/json; charset=utf-8
• The URL's bearer token
• A JSON object, even if empty ({})

For example:

curl --location --request POST 'webhookUrl' \
--header 'Authorization: Bearer bearerToken' \
--header 'Content-Type: application/json' \
--data-raw '{}'