Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.messagedesk.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Developer Tools

The Developer Tools page is where you configure the workspace-level webhook endpoint and signing secret that MessageDesk uses to push events to your systems.
Required for the Send Webhook relay action. This configuration must exist before the Send Webhook action will deliver events from your Relays.

​
Open Developer Tools

Go to Account → Settings → Workspace Settings → Developer Tools.

​
Add a webhook endpoint URL

  1. Click Add endpoint (or edit your existing endpoint).
  2. Enter the URL that MessageDesk should POST events to. It must:
    • Use HTTPS
    • Be reachable from the public internet
    • Respond with a 2xx status code on success
  3. Click Save.
You can configure your endpoint here once and reference it from any number of Relays that use the Send Webhook action.

​
Generate and rotate your signing secret

MessageDesk signs every outbound webhook with a signing secret so your receiver can verify the request really came from MessageDesk.
  • Generate — click Generate signing secret the first time you set up Developer Tools.
  • View / copy — copy the secret into your receiver’s configuration. Store it somewhere safe.
  • Rotate — click Rotate signing secret to generate a new value. Update your receiver immediately—webhooks signed with the previous secret will fail validation after rotation.
Treat the signing secret like a password. Anyone with the secret can forge webhook requests that look like they came from MessageDesk.
For the full webhook payload format, headers, signature validation algorithm, and retry behavior, see Relays → Send Webhook.

​
See also