GudDesk

GudDesk webhooks

GudDesk can POST JSON to your URL when conversations change. Use that to update your own tools, start a workflow, or feed an agent you host.

What it does

  • Sends an HTTP POST when a subscribed event fires.
  • Signs each body with HMAC SHA-256 in X-GudDesk-Signature.
  • Retries failed deliveries (up to 6 attempts with backoff).
  • Lets you pick which events each endpoint receives.

Setup

  1. 1

    Open Workspace Settings > Webhooks (or use the agent webhook API if you are wiring a bot).

  2. 2

    Add your HTTPS endpoint URL.

  3. 3

    Subscribe to the events you need.

  4. 4

    Copy the signing secret and verify X-GudDesk-Signature on every request.

  5. 5

    Optional: send a test ping from the dashboard to confirm your server returns 2xx quickly.

If your receiver is on localhost, tunnel with something like ngrok.

Events you can subscribe to

These are the events in code today. A test ping is not a subscription filter.

EventSubscription fieldNotes
message.createdonMessageCreatedNew message
conversation.createdonConversationCreatedNew conversation
conversation.closedonConversationClosedConversation closed
conversation.assignedonConversationAssignedAssignment changed
ping(test only)Dashboard or API test ping. Not a normal subscription filter.

Limits

  • Webhooks are on the Free plan.
  • Your endpoint must accept POST and return 2xx quickly. Do heavy work after you reply.
  • Signature verification is your responsibility in production.

All integrations

Add an endpoint when you are ready

Read the webhook docs, or create a free workspace and add an endpoint.