IntegrationsWebhooks (Pro)

Webhooks Quick Start

Pro Feature

Webhook support is available exclusively for Reasoner Pro users.

Quick Start

1

Get Your Webhook Credentials

  1. Log into your Reasoner account
  2. Go to Settings → Integrations
  3. Find the Webhooks section
  4. Copy your username and password (or generate new credentials if needed)
Security Note

Keep these credentials secure. They allow direct access to your Reasoner account.

2

Send Your First Webhook Request

Choose your preferred method below and run the example to send a test request to Reasoner.

$# Replace USERNAME and PASSWORD with your actual credentials
>curl -X POST "https://webhook.reasoner.com" \
>  -H "Content-Type: application/json" \
>  -H "Authorization: Basic $(echo -n 'USERNAME:PASSWORD' | base64)" \
>  -d '{"message": "Hello from webhook!"}'
3

Verify Success

A successful request will return a 200 OK response. You can now check your Reasoner dashboard to see the received data.

API Reference

Endpoint

URL
stringRequired

https://webhook.reasoner.com

Method
stringRequired

POST

Headers

Content-Type
stringRequired

application/json

Authorization
stringRequired

Basic authentication header using your webhook credentials

Format: Basic <base64-encoded-credentials>

Where <base64-encoded-credentials> is the Base64 encoding of username:password

Request Body

Your request body must be valid JSON. Reasoner accepts any valid JSON structure, giving you flexibility in what data you send.

Simple example:

1{
2  "message": "Hello from webhook!"
3}

More complex example:

1{
2  "event": "new_data",
3  "timestamp": "2023-06-15T14:22:10Z",
4  "source": "inventory_system",
5  "data": {
6    "product_id": "SKU-12345",
7    "quantity": 25,
8    "location": "Warehouse B"
9  }
10}

Creating the Authorization Header

The webhook uses HTTP Basic Authentication. You need to:

  1. Combine your username and password with a colon: username:password
  2. Encode this string in Base64
  3. Add Basic prefix to the encoded string
$# Linux/Mac
>echo -n 'username:password' | base64
>
># Windows PowerShell
>[Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes("username:password"))

Next Steps

For more advanced usage, including complete code examples, best practices, and troubleshooting, see our Advanced Usage guide.