Quick Start

Overview

This guide will walk you through the complete process of getting started with Discord Webhook Manager, from creating your account to sending your first message.

This quick start assumes you’re using a hosted instance of Discord Webhook Manager. If you need to self-host, see the Installation Guide.

Prerequisites

Before you begin, you’ll need:

Discord Webhook URL

You’ll need a Discord webhook URL from your Discord server. If you don’t have one yet, follow these steps:

Open your Discord server
Go to Server Settings → Integrations → Webhooks
Click New Webhook or Create Webhook
Customize the webhook name and channel
Click Copy Webhook URL

Your webhook URL will look like:

https://discord.com/api/webhooks/123456789/abcdefghijklmnop

Email Address

A valid email address for account registration and verification.

Step 1: Create Your Account

Navigate to Registration

Go to the Discord Webhook Manager application and click Sign Up or Register.

Fill in Your Information

Enter your account details:

Name: Your display name
Email: Your email address
Password: A secure password (minimum 8 characters)
Confirm Password: Re-enter your password

If registration is disabled by the administrator, you’ll need to contact the platform admin for an account.

Verify Your Email

Check your email inbox for a verification link and click it to activate your account. You won’t be able to access the platform until your email is verified.

Return to the login page and sign in with your email and password.

Step 2: Add Your First Webhook

Once logged in, you’ll see the dashboard. Let’s add your first webhook:

Navigate to Webhooks

Click Webhooks in the sidebar navigation or click Add Webhook from the dashboard.

Enter Webhook Details

Fill in the webhook form:

Webhook URL: https://discord.com/api/webhooks/YOUR_WEBHOOK_ID/YOUR_TOKEN
Name: My First Webhook

The system automatically validates your webhook URL with Discord’s API and can auto-fill the name and avatar from Discord.

Handle Duplicate Detection

If you try to add a webhook that already exists, you’ll see a duplicate warning with options to:

Use existing webhook: Navigate to the existing webhook
Create anyway: Create a new entry (useful for testing or different contexts)

Save the Webhook

Click Save or Create Webhook. You’ll be redirected to your webhooks list where you can see:

Webhook name and avatar
Guild (server) and channel information
Last used timestamp
Quick actions (edit, send, history)

Step 3: Send Your First Message

Now let’s send a message through your webhook:

Choose a Sending Method

You have two options:Option A: From Saved Webhook

Click Send Message next to your webhook in the webhooks list

Option B: Quick Send

Click Quick Send in the sidebar
Select “Use Saved Webhook” mode
Choose your webhook from the dropdown

Compose Your Message

The message editor provides multiple options:

Simple Text Message

Type your message content (up to 2,000 characters):

Hello from Discord Webhook Manager! 🚀
This is my first automated message.

Add Mentions (Optional)

You can mention users or roles:

@everyone - Mentions everyone
@here - Mentions online users
<@USER_ID> - Mentions specific user
<@&ROLE_ID> - Mentions specific role

Be cautious with @everyone and @here mentions as they can notify large numbers of users.

Create an Embed (Optional)

For richer messages, add an embed by clicking Add Embed:

Basic Embed Structure

Title: “Welcome to Our Community” (max 256 characters)Description: “We’re excited to have you here! Check out our rules and introduce yourself.” (max 4,096 characters)Color: Choose a hex color like #5865F2 (Discord blue)

Advanced Embed Elements

Author: Add author name, icon, and URLFooter: Add footer text and iconTimestamp: Show current time on the embedImage: Add a large image URLThumbnail: Add a small thumbnail image URLFields: Add custom fields (supports inline layout)

Field Name (max 256 characters)
Field Value (max 1,024 characters)
Inline toggle (display multiple fields side-by-side)

You can add up to 10 embeds per message. Use the real-time preview on the right to see exactly how your message will appear in Discord.

Preview Your Message

The right side of the editor shows a real-time preview that matches Discord’s appearance exactly. Make sure everything looks correct before sending.

Send the Message

Click Send Message at the bottom of the editor. You’ll see a success notification, and the message will appear immediately in your Discord channel.

All sent messages are logged in the message history, accessible from the webhook’s History button.

Quick Send with Temporary Webhook

If you want to send a one-off message without saving the webhook:

Enable Temporary Mode

Go to Quick Send and toggle “Use Temporary Webhook”.

Enter Webhook Details

Paste your Discord webhook URL directly and optionally customize:

Webhook name (displayed in Discord)
Avatar URL (displayed in Discord)

Compose and Send

Create your message as described above and click Send. The webhook won’t be saved to your account.

Example: Creating a Professional Announcement

Here’s a complete example of a professional announcement embed:

{
  "content": "@everyone New update available!",
  "embeds": [
    {
      "title": "Version 2.0 Released 🎉",
      "description": "We're excited to announce our biggest update yet! This release includes major performance improvements and new features.",
      "color": "#07d3b4",
      "author": {
        "name": "Development Team",
        "icon_url": "https://example.com/team-icon.png"
      },
      "fields": [
        {
          "name": "✨ New Features",
          "value": "• AI-powered content generation\n• Improved scheduling\n• Better collaboration tools",
          "inline": false
        },
        {
          "name": "🐛 Bug Fixes",
          "value": "• Fixed timezone issues\n• Improved error handling\n• Performance optimizations",
          "inline": false
        }
      ],
      "footer": {
        "text": "Released today"
      },
      "timestamp": true
    }
  ]
}

Next Steps

Now that you’ve sent your first message, explore these powerful features:

Schedule Messages

Automate your messages with one-time or recurring schedules

Create Templates

Save message designs for quick reuse with dynamic variables

Invite Team Members

Share webhooks with your team using role-based permissions

AI Generation

Use AI to generate message content automatically (requires admin setup)

Tips & Best Practices

Message Design Tips

Keep titles concise and descriptive (under 100 characters)
Use consistent colors that match your brand or Discord server theme
Add timestamps to announcements for context
Use fields to organize information clearly
Test messages in a private channel before sending to large audiences

Webhook Organization

Use descriptive names for webhooks (“Marketing Announcements” vs “Webhook 1”)
Add tags to categorize webhooks by purpose or server
Use descriptions to document webhook purpose for team members
Review webhook history regularly to track what’s been sent

Mention Etiquette

Avoid overusing @everyone and @here mentions
Reserve mass mentions for truly important announcements
Consider time zones when scheduling messages with mentions
Test mention permissions in your Discord server first

Security

Never share your webhook URLs publicly
Use the collaboration feature instead of sharing webhook URLs
Regenerate webhook URLs in Discord if they’re compromised
Regularly review collaborators and remove access when needed

Troubleshooting

Webhook validation fails

Possible causes:

Invalid webhook URL format
Webhook was deleted in Discord
Network connectivity issues

Solutions:

Verify the webhook still exists in Discord Server Settings
Check that you copied the complete URL
Ensure the URL starts with https://discord.com/api/webhooks/ or https://discordapp.com/api/webhooks/

Message fails to send

Possible causes:

Webhook was deleted or regenerated in Discord
Message exceeds Discord’s limits
Invalid embed structure

Solutions:

Check webhook history for error details
Verify message content is under 2,000 characters
Ensure embed descriptions are under 4,096 characters
Verify you have fewer than 10 embeds
Check that image URLs are valid and accessible

Email verification not received

Solutions:

Check your spam/junk folder
Ensure you entered the correct email address
Wait a few minutes and try requesting a new verification email
Contact the platform administrator if the issue persists

Preview doesn't match Discord

The preview should match Discord exactly. If it doesn’t:

Refresh the page
Clear browser cache
Report the issue on GitHub with screenshots

Getting Help

Need More Help?

Documentation: Browse the full documentation for detailed guides
GitHub Issues: Report bugs or request features on GitHub
Community: Check the project discussions for community support

Get Started

Core Features

Collaboration

Advanced

Deployment

Overview

Prerequisites

Step 1: Create Your Account

Step 2: Add Your First Webhook

Step 3: Send Your First Message

Simple Text Message

Add Mentions (Optional)

Quick Send with Temporary Webhook

Example: Creating a Professional Announcement

Next Steps

Schedule Messages

Create Templates

Invite Team Members

AI Generation

Tips & Best Practices

Troubleshooting

Getting Help

Need More Help?

Build docs developers (and LLMs) love

Get Started

Core Features

Collaboration

Advanced

Deployment

Documentation Index

​Overview

​Prerequisites

​Step 1: Create Your Account

​Step 2: Add Your First Webhook

​Step 3: Send Your First Message

​Simple Text Message

​Add Mentions (Optional)

​Quick Send with Temporary Webhook

​Example: Creating a Professional Announcement

​Next Steps

Schedule Messages

Create Templates

Invite Team Members

AI Generation

​Tips & Best Practices

​Troubleshooting

​Getting Help

Need More Help?

Build docs developers (and LLMs) love

Overview

Prerequisites

Step 1: Create Your Account

Step 2: Add Your First Webhook

Step 3: Send Your First Message

Simple Text Message

Add Mentions (Optional)

Quick Send with Temporary Webhook

Example: Creating a Professional Announcement

Next Steps

Tips & Best Practices

Troubleshooting

Getting Help