Getting Started

Alphorn is an open-source, self-hostable notification routing platform. Receive webhooks, route messages to any channel with filtering, retries, and real-time streaming.

Quick StartCopy Anchor Link

1. Choose your deploymentCopy Anchor Link

You can use Alphorn in two ways:

• Hosted - Sign up at app.alphorn.dev and start sending immediately.
• Self-hosted - Run Alphorn on your own infrastructure. See the Self-Hosting guide for details.

2. Add a channelCopy Anchor Link

After signing in, go to Channels and configure where you want notifications delivered - Slack, Discord, Email, SMS, or any of the supported channels.

3. Create a webhookCopy Anchor Link

Go to Webhooks, create a webhook, and select the channel from step 2. Alphorn gives you a unique URL:

https://app.alphorn.dev/n/V1StGXR8_Z5jdHi6B-myT

Keep the URL private: by default it is the only secret. To also require an API key, switch on API key required when creating the webhook and copy the key right away (it is shown only once). See API key.

4. Send a notificationCopy Anchor Link

curl -X POST https://app.alphorn.dev/n/V1StGXR8_Z5jdHi6B-myT \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Deploy Complete",
    "message": "v2.1.0 deployed to production",
    "priority": 3,
    "tags": ["deploy", "production"]
  }'

That's it. Alphorn answers with 201 and routes the message to all matching channels with automatic retries.

Core ConceptsCopy Anchor Link

• Webhooks - HTTP endpoints that receive incoming notifications
• Channels - Destinations where notifications are delivered (Slack, Email, etc.)
• Filtering Rules - Route messages based on priority, tags, or payload content
• Retries - Failed deliveries automatically retry with exponential backoff
• Projects - Multi-tenant workspaces with role-based access control

Next StepsCopy Anchor Link