Skip to main content

Quickstart

This guide walks you through receiving your first webhook and delivering it to Discord.

Prefer to watch first? The 90-second demo above covers the same flow end-to-end. More walkthroughs on our YouTube channel.

1. Sign up​

When you first sign in, Dispatch sets you up automatically: you get a default organization and a Default Project, and land on the project's overview page. Organizations are the top-level container for projects, members, and billing; the project is where you'll manage your webhook endpoints, destinations, and templates. Both can be renamed in their settings pages, and you can create more of either at any time.

The overview shows a Project setup checklist that walks you through the rest of this guide — add a source, add a destination, connect them, and send your first event. It checks itself off as you go and disappears when the project is fully wired up.

note

Joining from a team invite? You're added to your team's organization instead — no default workspace is created.

2. Create a Webhook Endpoint (Source)​

Navigate to Sources and create a new endpoint. Dispatch will generate:

  • A unique slug — your webhook URL will be https://your-api.com/hooks/:slug
  • A signing secret — used to verify incoming requests

Copy the signing secret and configure it in your external service.

3. Create a Destination​

Navigate to Destinations and create a Discord destination:

  • Manual: Paste a Discord webhook URL directly
  • OAuth: Connect your Discord account and select a channel

In the Sources page, link your endpoint to your destination. You can optionally assign a message template.

5. Send a Test Event​

Use the Test button on your endpoint to send a test event, or POST to your endpoint:

# Using signing secret
SIGNATURE=$(echo -n '{"test": true}' | openssl dgst -sha256 -hmac "your-signing-secret" | cut -d' ' -f2)

curl -X POST https://your-api.com/hooks/your-slug \
  -H "Content-Type: application/json" \
  -H "X-Dispatch-Signature: sha256=$SIGNATURE" \
  -d '{"test": true}'
# Using API key
curl -X POST https://your-api.com/hooks/your-slug \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer dsp_your-api-key" \
  -d '{"test": true}'

6. Verify Delivery​

Check the Events page to see your event and its delivery status. The event should show as received with a successful delivery attempt to your Discord channel.

Next Steps​