Skip to main content
All articles
· Updated July 3, 2026

How to Get a Discord Webhook URL (Desktop & Mobile 2026)

Learn exactly how to get a Discord webhook URL step by step on desktop and mobile. Includes permissions, troubleshooting, and how to send your first message.

beginnersetupguidewebhookdiscord webhook urlhow to get webhookdiscord webhook 2026

🇷🇺 Also available in Русский

How to Get a Discord Webhook URL (Desktop & Mobile 2026)

A Discord webhook URL is the single most important thing you need before you can send automated messages to a channel. This guide shows you exactly how to get one — on both desktop and mobile — in under two minutes, explains the permissions you need, and helps you fix the most common problems.

What is a Discord Webhook URL?

A webhook URL is a unique, secret address that points directly to one Discord channel. When any application, script, or service sends an HTTP POST request to that URL, Discord instantly posts the message in the channel. No bot, no login, no token exchange.

A webhook URL always looks like this:

https://discord.com/api/webhooks/1234567890123456789/AbCdEf-XyZ_your-secret-token

It has two parts: the numeric webhook ID and the long token. Anyone who has the full URL can post to your channel, so treat it like a password.

What You Need First

To create a webhook you must have the Manage Webhooks permission in the server. This is included in the Administrator role, but on servers you don’t own you may need to ask an admin to grant it or create the webhook for you.

You also need to pick the channel where messages will appear. Each webhook is tied to exactly one channel (though you can change it later).

How to Get a Discord Webhook URL on Desktop

  1. Open Discord and go to the server where you want messages posted.
  2. Hover over the target text channel and click the gear icon (Edit Channel). Alternatively open Server Settings → Integrations.
  3. Select Integrations, then click Webhooks.
  4. Click New Webhook. Discord creates one with a default name and avatar.
  5. (Optional) Rename it and pick the channel it should post to.
  6. Click Copy Webhook URL.

That copied string is your webhook URL. Paste it somewhere safe — you’ll need it in every script or integration.

Tip: Click Save Changes before leaving the settings page, otherwise a newly created webhook may not persist.

How to Get a Discord Webhook URL on Mobile

The mobile app hides webhooks a little deeper, but the steps are the same:

  1. Open the Discord app and tap your server name at the top.
  2. Tap Settings (or long-press the channel → Edit Channel).
  3. Go to Integrations → Webhooks → New Webhook.
  4. Tap the webhook, choose the channel, then tap Copy Webhook URL.

Once copied, you can paste the URL into a notes app, a shortcut, or directly into the tool you’re using.

Send Your First Message

With the URL in hand, test it immediately. The fastest way is our free visual webhook builder — paste the URL, type a message or design an embed, and hit send. No code required.

If you prefer the command line, here is a one-line test with curl:

curl -H "Content-Type: application/json" \
  -d '{"content": "It works! 🎉"}' \
  "https://discord.com/api/webhooks/YOUR_WEBHOOK_URL"

A successful request returns HTTP 204 No Content and the message appears in your channel. For a full walkthrough see our complete setup guide, or jump into language-specific tutorials for Python, JavaScript, and cURL.

Troubleshooting

I don’t see the Integrations or Webhooks option. You lack the Manage Webhooks permission. Ask the server owner to grant your role that permission, or to create the webhook and share the URL with you.

The “New Webhook” button is greyed out. The channel type may not support webhooks (voice and category channels don’t). Choose a standard text channel or a forum channel.

My message returns a 401 or 404 error. The URL is wrong, incomplete, or the webhook was deleted. Recopy the full URL — including both the ID and the token — and make sure nothing was cut off. See our webhook errors guide for every status code explained.

Messages send but the embed looks broken. Discord returns 204 even when an embed has invalid fields. Validate your payload against the embed limits and build it visually in the builder first.

Keep Your Webhook URL Secure

Because the URL is all anyone needs to post in your channel, never commit it to a public repository or paste it in screenshots. Store it in an environment variable and rotate it if it leaks. Our webhook security guide covers rotation, per-service webhooks, and abuse monitoring in depth.

Next Steps

Now that you have a working webhook URL, you can:

The easiest place to start is the free Discord Webhook Builder — design your message visually, then export the JSON for your own scripts.

Try it in our tool

Open Discord Webhook Builder