KeyCrate Docs

Appearance

Webhooks ​

Webhooks enable your application to receive real-time notifications when events occur on either via api calls to specific endpoints or actions done in the dashboard. You can configure webhooks to send HTTP POST requests to your server with event data, or send formatted messages to Discord channels.

Keycrate supports two types of webhooks: Normal Webhooks (HTTP POST requests) and Discord Webhooks (Discord channel messages).

🪜 Creating a Webhook ​

Normal Webhooks ​

  1. Navigate to Webhooks → Normal Webhooks.
  2. Select an Application and Endpoint from the dropdowns.
  3. Click the Create Webhook tab.
  4. Fill in the webhook details:
    • Name: A descriptive name for your webhook (e.g., "License Created Event").
    • Webhook URL: The HTTP endpoint where you want to receive POST requests (eg., "/license/create).
  5. Click Save.

Your webhook will now trigger whenever the selected endpoint generates an event, sending a POST request with the event data as JSON.

Discord Webhooks ​

  1. Navigate to Webhooks → Discord Webhooks.
  2. Select an Application and Endpoint from the dropdowns.
  3. Click the Create Webhook tab.
  4. Fill in the webhook details:
    • Name: A descriptive name for your webhook.
    • Discord Webhook URL: A valid Discord webhook URL (obtain this from your Discord server settings).
    • Message Content: Optional plain text message to include.
    • Embed Configuration: Customize the Discord embed (title, description, color, fields, etc.).
    • Placeholders: Use available endpoint placeholders (like $license_key, $subscription_id) to insert dynamic data.
  5. Click Save.

A preview of your Discord message will display before saving, showing how it will appear in Discord.