How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Discord Webhooks API

The Webhooks API from Discord — 8 operation(s) for webhooks.

Discord Webhooks API is one of 29 APIs that Discord publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Webhook. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 18 operations across 8 paths, and defines 130 schemas. It is described by OpenAPI 3.1.0, at version 10.

Requests are made against a single base URL, https://discord.com/api/v10.

18 operations 8 paths 130 schemas 4 DELETE6 GET4 PATCH4 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
10
Base URL
https://discord.com/api/v10
Authentication
HTTP Bearer
Terms of Service
Resource Areas
1

Authentication & Security 1

Discord Webhooks API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (BotToken). By default, every request must be authenticated.

  • BotToken — Bot token authentication

Paths & Operations 18

Across 8 paths, the API surfaces 18 operations — 4 DELETE, 6 GET, 4 PATCH, 4 POST. Each is listed below with its method, path, parameters, and response codes.

Webhooks 18
GET
/webhooks/{webhook_id}/{webhook_token}/messages/@original
get_original_webhook_message 3 params → 2004XX
DELETE
/webhooks/{webhook_id}/{webhook_token}/messages/@original
delete_original_webhook_message 3 params → 2044XX
PATCH
/webhooks/{webhook_id}/{webhook_token}/messages/@original
update_original_webhook_message 3 params body → 2004XX
GET
/webhooks/{webhook_id}/{webhook_token}/messages/{message_id}
get_webhook_message 4 params → 2004XX
DELETE
/webhooks/{webhook_id}/{webhook_token}/messages/{message_id}
delete_webhook_message 4 params → 2044XX
PATCH
/webhooks/{webhook_id}/{webhook_token}/messages/{message_id}
update_webhook_message 4 params body → 2004XX
POST
/webhooks/{webhook_id}/{webhook_token}/github
execute_github_compatible_webhook 4 params body → 2044XX
POST
/webhooks/{webhook_id}/{webhook_token}/slack
execute_slack_compatible_webhook 4 params body → 2004XX
GET
/webhooks/{webhook_id}/{webhook_token}
get_webhook_by_token 2 params → 2004XX
POST
/webhooks/{webhook_id}/{webhook_token}
execute_webhook 4 params body → 2002044XX
DELETE
/webhooks/{webhook_id}/{webhook_token}
delete_webhook_by_token 2 params → 2044XX
PATCH
/webhooks/{webhook_id}/{webhook_token}
update_webhook_by_token 2 params body → 2004XX
GET
/webhooks/{webhook_id}
get_webhook 1 param → 2004XX
DELETE
/webhooks/{webhook_id}
delete_webhook 1 param → 2044XX
PATCH
/webhooks/{webhook_id}
update_webhook 1 param body → 2004XX
GET
/channels/{channel_id}/webhooks
Discord List channel webhooks
getChannelWebhooks 1 param → 2004XX
POST
/channels/{channel_id}/webhooks
Discord Create webhook
createWebhook 1 param body → 2004XX
GET
/guilds/{guild_id}/webhooks
Discord List guild webhooks
getGuildWebhooks 1 param → 2004XX

Schemas 130

The contract defines 130 schemas that model the data the API accepts and returns. The most detailed are MessageResponse (34 properties), BasicMessageResponse (32 properties), GuildChannelResponse (24 properties), ThreadResponse (21 properties). Each schema is shown below with its type and property counts.

MessageReactionCountDetailsResponse
object
2 properties 2 required
Int53Type
integer
ApplicationTypes
integer
MessageRoleSubscriptionDataResponse
object
4 properties 4 required
InputText
object
9 properties 4 required
GithubRelease
object
4 properties 4 required
ChannelSelectDefaultValue
object
2 properties 2 required
StringSelect
object
7 properties 3 required
ApplicationResponse
object
21 properties 5 required
ChannelFollowerWebhookResponse
object
10 properties 3 required
MessageComponentRoleSelectResponse
object
7 properties 3 required
Button
object
8 properties 2 required
RichEmbedVideo
object
5 properties
GithubAuthor
object
2 properties 1 required
StickerFormatTypes
integer
GithubRepository
object
4 properties 4 required
MessageEmbedVideoResponse
object
6 properties
GithubCheckSuite
object
5 properties 2 required
ThreadMetadataResponse
object
6 properties 3 required
ResolvedObjectsResponse
object
4 properties 4 required
SnowflakeType
string
StickerTypes
integer
BasicApplicationResponse
object
8 properties 3 required
GithubCheckApp
object
1 property 1 required
MessageEmbedFooterResponse
object
3 properties 1 required
MessageEmbedImageResponse
object
6 properties
MessageComponentStringSelectResponse
object
8 properties 3 required
Webhook
object
10 properties 2 required
MessageCallResponse
object
2 properties 1 required
User
object
17 properties 2 required
PurchaseNotificationResponse
object
2 properties 1 required
Error
object
A single error, either for an API response or a specific field.
2 properties 2 required
GithubCheckPullRequest
object
1 property 1 required
GithubReview
object
4 properties 3 required
UserResponse
object
11 properties 5 required
StandardStickerResponse
object
8 properties 6 required
ChannelPermissionOverwrites
integer
GithubWebhook
object
20 properties 1 required
IncomingWebhookRequestPartial
object
11 properties
SnowflakeSelectDefaultValueTypes
string
GuildChannelResponse
object
24 properties 6 required
PrivateChannelResponse
object
6 properties 4 required
GithubCheckRunOutput
object
2 properties
WebhookSourceGuildResponse
object
3 properties 2 required
MessageReferenceResponse
object
4 properties 1 required
UserSelect
object
7 properties 2 required
UInt32Type
integer
GithubIssue
object
7 properties 5 required
RichEmbedFooter
object
2 properties
MessageEmbedResponse
object
13 properties 1 required
GuildRoleResponse
object
12 properties 8 required
ThreadSortOrder
integer
RichEmbedImage
object
5 properties
GuildMemberResponse
object
12 properties 7 required
Snowflake
string
Discord unique ID represented as a string
GithubUser
object
4 properties 4 required
SelectOption
object
5 properties 2 required
RoleSelectDefaultValue
object
2 properties 2 required
RichEmbedField
object
3 properties 2 required
DefaultReactionEmojiResponse
object
2 properties
ThreadAutoArchiveDuration
integer
MessageComponentInputTextResponse
object
10 properties 4 required
OAuth2Scopes
string
VideoQualityModes
integer
MessageResponse
object
34 properties 15 required
GithubDiscussion
object
6 properties 4 required
ForumTagResponse
object
5 properties 3 required
MessageComponentChannelSelectResponse
object
8 properties 3 required
MessageComponentTypes
integer
UserSelectDefaultValue
object
2 properties 2 required
MessageAttachmentResponse
object
16 properties 5 required
ChannelPermissionOverwriteResponse
object
4 properties 4 required
MessageEmbedFieldResponse
object
3 properties 3 required
MessageMentionChannelResponse
object
4 properties 4 required
RichEmbedAuthor
object
3 properties
MessageComponentMentionableSelectResponse
object
7 properties 3 required
GithubCommit
object
4 properties 4 required
ErrorDetails
ThreadMemberResponse
object
5 properties 4 required
MessageReferenceType
integer
GithubComment
object
5 properties 4 required
InteractionTypes
integer
GuildRoleTagsResponse
object
6 properties
GithubCheckRun
object
7 properties 3 required
TextStyleTypes
integer
MessageActivityResponse
object
MessageComponentEmojiResponse
object
3 properties 1 required
ThreadResponse
object
21 properties 9 required
MessageType
integer
GuildStickerResponse
object
9 properties 6 required
ActionRow
object
2 properties 2 required
InnerErrors
object
1 property 1 required
IncomingWebhookUpdateRequestPartial
object
6 properties
ChannelSelect
object
8 properties 2 required
MentionableSelect
object
7 properties 2 required
ButtonStyleTypes
integer
MessageReactionEmojiResponse
object
3 properties
RichEmbedProvider
object
2 properties
AllowedMentionTypes
string
ApplicationOAuth2InstallParamsResponse
object
2 properties 2 required
PrivateGroupChannelResponse
object
11 properties 4 required
WebhookSlackEmbed
object
14 properties
MessageComponentButtonResponse
object
8 properties 3 required
UserAvatarDecorationResponse
object
MessageComponentActionRowResponse
object
3 properties 2 required
MessageStickerItemResponse
object
3 properties 3 required
MessageAllowedMentionsRequest
object
4 properties
MessageAttachmentRequest
object
4 properties 1 required
WebhookTypes
integer
RichEmbed
object
13 properties
MessageEmbedAuthorResponse
object
4 properties 1 required
Emoji
object
3 properties 1 required
RichEmbedThumbnail
object
5 properties
SlackWebhook
object
4 properties
MessageEmbedProviderResponse
object
2 properties 1 required
BasicMessageResponse
object
32 properties 15 required
GuildProductPurchaseResponse
object
2 properties 2 required
ForumLayout
integer
ErrorResponse
object
Errors object returned by the Discord API
SelectOptionResponse
object
5 properties 2 required
ApplicationIncomingWebhookResponse
object
8 properties 3 required
PurchaseType
integer
MessageInteractionResponse
object
5 properties 3 required
WebhookSlackEmbedField
object
3 properties
WebhookSourceChannelResponse
object
2 properties 2 required
RoleSelect
object
7 properties 2 required
MessageComponentUserSelectResponse
object
7 properties 3 required
GuildIncomingWebhookResponse
object
10 properties 3 required
MessageReactionResponse
object
6 properties 6 required
ChannelTypes
integer

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

discord-webhooks-api-openapi.yml Raw ↑

Other APIs Discord publishes across the network.

Discord Gateway API
Discord Interactions API
Discord OAuth2 API
Discord Webhook Events API
Discord Embedded App SDK
Discord Voice API
Discord Social SDK
Discord Application Commands API
Discord Applications API
Discord Audit Log API
Discord Auto Moderation API
Discord Channels API
Where this information came from

This is an independent, third-party profile of Discord Webhooks API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.