/webhooks

Returns information on either all guild webhooks or webhook in a specified channel.

This endpoint supports the Exclude header

This endpoint is only on the BETA Version of the API and may be unstable.

Please report any & all bugs to the Support Server

Endpoint Headers:

• bot-token - Token of the Bot [String] (Required)

• apikey - Your Api Auth Key [String] (Required)

• guild-id - ID of the guild to be fetched [Snowflake] (Required)

• channel-id - ID of the channel to fetch webhooks from [Snowflake] (Optional)

If no channel-id was specified, it will grab all webhooks in the guild.

Examples:

Data API version required. Must replace <version> with either release or beta.

Bot Designer for Discord

Example usage of /guild/webhooks endpoint using BDFD

$httpAddHeader[apikey;<YOUR-API-KEY>]
$httpAddHeader[bot-token;<YOUR-BOT-TOKEN>]
$httpAddHeader[guild-id;1064098700307218463] 
$httpAddHeader[channel-id;1064098700307218463] $c[Optional Header]
$httpGet[https://bdfddata.rickyjs.xyz/<version>/guild/webhooks]


$httpResult OR $httpResult[details]

Discord.js

Example usage of /guild/webhooks endpoint using Discord.js

const axios = require('axios');
(async () => {
return await axios.get('https://bdfddata.rickyjs.xyz/<version>/guild/webhooks', { 
headers: {
'apikey': <YOUR-API-KEY>,
'bot-token': <YOUR-BOT-TOKEN>,
'guild-id': '1064098700307218463',
'channel-id': '1064098700307218463' //Optiona Header
}
}).then(res=>res.data)
})()

Possible Responses (Codes)

Code 200

API succeeded and details were fetched.

{
  status: 200,
  details:[{
        "application_id": "865524120573181972",
        "avatar": "52485cc8a0cb9e4df97fc601771a09ec",
        "channel_id": "1066204100296974427",
        "guild_id": "1064098700307218463",
        "id": "1066204434419433493",
        "name": "Status Notifier",
        "type": 1,
        "user": {
            "id": "865524120573181972",
            "username": "Status Notifier",
            "avatar": "afdb2b0f63acaca8b2859f705020d991",
            "discriminator": "0143",
            "public_flags": 65536,
            "flags": 65536,
            "bot": true,
            "banner": null,
            "accent_color": null,
            "global_name": null,
            "avatar_decoration_data": null,
            "collectibles": null,
            "banner_color": null,
            "clan": null,
            "primary_guild": null
        }
    }]
    // Read more on Webhook Objects: https://discord.com/developers/docs/resources/webhook#webhook-resource
}

Code 400

An error occurred that stopped execution.

{
    status: 400
    error: 'Cannot read ...  (This can vary)'
}

Code 401

Invalid bot token was provided.

{
  status: 401,
  details: { message: '401: Unauthorized', code: 0 }
}

Code 404

Guild was not found via DAPI

{
  status: 404,
  details: { message: 'Unknown Guild', code: 10004 } (this can vary)
}