Integrate AI chatbots with Hookdeck

Step-by-Step Guide to Creating a Webhook with Hookdeck

1. Prerequisites: Ensure you have your API key from your Hookdeck project secrets.

2. Set Up a Connection:

   • Use the following cURL command to create a connection:

   curl --location 'https://api.hookdeck.com/2023-07-01/connections' \
   --header 'Content-Type: application/json' \
   --header 'Authorization: Bearer YOUR_PROJECT_API_KEY' \
   --data '{
     "name": "inbound-quickstart-connection",
     "source": { "name": "inbound-webhook" },
     "destination": { "name": "outbound-webhook", "url": "https://mock.hookdeck.com" }
   }'
   

3. Receive a Test Webhook:

   • Make a POST request to the inbound webhook URL:

   curl --location '{YOUR_SOURCE_URL}' \
   --header 'Content-Type: application/json' \
   --data-raw '{ "type": "order.created", "timestamp": "2023-11-18 17:23:30", "email": "customer@example.com" }'
   

4. Use Hookdeck CLI for Local Development:

   • Start your local server and run:

   hookdeck listen 3030 inbound-webhook --path /webhook
   

5. Test Receiving Webhooks Locally:

   • Send a test webhook to your local server using the CLI and observe the logs.

6. End-to-End Delivery: Set up the production endpoint to receive webhooks from the third-party service.

For more detailed instructions, refer to the Hookdeck Quickstart Guide.