A webhook endpoint is a URL on your server that receives event payloads from DMSI Webhooks.
Where to Create #
Go to DDLS > Webhooks > Endpoints and click Add New Endpoint.
Required Fields #
| Field | Description |
|---|---|
| Name | A human-readable label for this endpoint (e.g., “Production CRM”) |
| URL | The HTTPS URL that will receive POST requests |
Optional Fields #
| Field | Default | Description |
|---|---|---|
| Timeout | 30s | HTTP request timeout in seconds |
| Max Retries | 5 | Maximum delivery attempts (0–5) |
| Custom Headers | None | Additional HTTP headers to include in every delivery |
| Auto-Subscribe | Off | Automatically subscribe to new events as they are registered |
| Debug Mode | Off | Log additional debug information for deliveries |
Saving the Endpoint #
When you click Save for a new endpoint:
- A 64-character hex signing secret is generated automatically
- The full signing secret is displayed once on the confirmation screen
- The secret is then encrypted and stored — it cannot be retrieved again
Copy and store the signing secret immediately. You will need it to verify incoming webhook signatures. If lost, you must rotate the key (which generates a new secret).
Endpoint Status #
After creation, an endpoint starts as active and begins receiving deliveries for subscribed events.
Related Topics #
- Endpoint Settings Reference
- Event Subscriptions
- Signing Secret Management