---
title: "GET /guilds/{guild_id}/webhooks"
method: GET
path: "/guilds/{guild_id}/webhooks"
---

# GET /guilds/{guild_id}/webhooks

`GET /guilds/{guild_id}/webhooks`

## Response `200`

200 response for get_guild_webhooks

- union[], nullable
  - union
    - ApplicationIncomingWebhookResponse
      - `application_id` string, snowflake, required
      - `avatar` string, nullable, required
      - `channel_id` string, snowflake, required
      - `guild_id` string, snowflake
      - `id` string, snowflake, required
      - `name` string, required
      - `type` union, required
        - 1 — Incoming Webhooks can post messages to channels with a generated token
        - 2 — Channel Follower Webhooks are internal webhooks used with Channel Following to post new messages into channels
        - 3 — Application webhooks are webhooks used with Interactions
      - `user` UserResponse
        - `id` string, snowflake, required
        - `username` string, required — the user's username, not unique across the platform
        - `avatar` string, nullable, required — the user's avatar hash
        - `discriminator` string, required — the user's Discord-tag
        - `public_flags` integer, required — the public flags on a user's account
        - `flags` integer, required
        - `bot` boolean — whether the user belongs to an OAuth2 application
        - `system` boolean — whether the user is an Official Discord System user (part of the urgent message system)
        - `banner` string, nullable — the user's banner hash
        - `accent_color` integer, nullable — the user's banner color encoded as an integer representation of hexadecimal color code
        - `global_name` string, nullable, required — the user's display name, if it is set
        - `avatar_decoration_data` UserAvatarDecorationResponse
          - `asset` string, required — the avatar decoration hash
          - `sku_id` string, snowflake, required
        - `collectibles` UserCollectiblesResponse
          - `nameplate` UserNameplateResponse, required
            - `sku_id` string, snowflake, required
            - `asset` string, required — Path to the nameplate asset
            - `label` string, required — The label of this nameplate. Currently unused
            - `palette` union, required
              - …
        - `primary_guild` UserPrimaryGuildResponse, required
          - `identity_guild_id` string, snowflake, required
          - `identity_enabled` boolean, nullable, required — whether the user is displaying the primary guild's server tag
          - `tag` string, nullable, required — the text of the user's server tag, limited to 4 characters
          - `badge` string, nullable, required — the server tag badge hash
    - ChannelFollowerWebhookResponse
      - `application_id` string, snowflake, required
      - `avatar` string, nullable, required
      - `channel_id` string, snowflake, required
      - `guild_id` string, snowflake
      - `id` string, snowflake, required
      - `name` string, required
      - `type` union, required
        - 1 — Incoming Webhooks can post messages to channels with a generated token
        - 2 — Channel Follower Webhooks are internal webhooks used with Channel Following to post new messages into channels
        - 3 — Application webhooks are webhooks used with Interactions
      - `user` UserResponse
        - `id` string, snowflake, required
        - `username` string, required — the user's username, not unique across the platform
        - `avatar` string, nullable, required — the user's avatar hash
        - `discriminator` string, required — the user's Discord-tag
        - `public_flags` integer, required — the public flags on a user's account
        - `flags` integer, required
        - `bot` boolean — whether the user belongs to an OAuth2 application
        - `system` boolean — whether the user is an Official Discord System user (part of the urgent message system)
        - `banner` string, nullable — the user's banner hash
        - `accent_color` integer, nullable — the user's banner color encoded as an integer representation of hexadecimal color code
        - `global_name` string, nullable, required — the user's display name, if it is set
        - `avatar_decoration_data` UserAvatarDecorationResponse
          - `asset` string, required — the avatar decoration hash
          - `sku_id` string, snowflake, required
        - `collectibles` UserCollectiblesResponse
          - `nameplate` UserNameplateResponse, required
            - `sku_id` string, snowflake, required
            - `asset` string, required — Path to the nameplate asset
            - `label` string, required — The label of this nameplate. Currently unused
            - `palette` union, required
              - …
        - `primary_guild` UserPrimaryGuildResponse, required
          - `identity_guild_id` string, snowflake, required
          - `identity_enabled` boolean, nullable, required — whether the user is displaying the primary guild's server tag
          - `tag` string, nullable, required — the text of the user's server tag, limited to 4 characters
          - `badge` string, nullable, required — the server tag badge hash
      - `source_guild` WebhookSourceGuildResponse
        - `id` string, snowflake, required
        - `icon` string, nullable, required
        - `name` string, required
      - `source_channel` WebhookSourceChannelResponse
        - `id` string, snowflake, required
        - `name` string, required
    - GuildIncomingWebhookResponse
      - `application_id` string, snowflake, required
      - `avatar` string, nullable, required
      - `channel_id` string, snowflake, required
      - `guild_id` string, snowflake
      - `id` string, snowflake, required
      - `name` string, required
      - `type` union, required
        - 1 — Incoming Webhooks can post messages to channels with a generated token
        - 2 — Channel Follower Webhooks are internal webhooks used with Channel Following to post new messages into channels
        - 3 — Application webhooks are webhooks used with Interactions
      - `user` UserResponse
        - `id` string, snowflake, required
        - `username` string, required — the user's username, not unique across the platform
        - `avatar` string, nullable, required — the user's avatar hash
        - `discriminator` string, required — the user's Discord-tag
        - `public_flags` integer, required — the public flags on a user's account
        - `flags` integer, required
        - `bot` boolean — whether the user belongs to an OAuth2 application
        - `system` boolean — whether the user is an Official Discord System user (part of the urgent message system)
        - `banner` string, nullable — the user's banner hash
        - `accent_color` integer, nullable — the user's banner color encoded as an integer representation of hexadecimal color code
        - `global_name` string, nullable, required — the user's display name, if it is set
        - `avatar_decoration_data` UserAvatarDecorationResponse
          - `asset` string, required — the avatar decoration hash
          - `sku_id` string, snowflake, required
        - `collectibles` UserCollectiblesResponse
          - `nameplate` UserNameplateResponse, required
            - `sku_id` string, snowflake, required
            - `asset` string, required — Path to the nameplate asset
            - `label` string, required — The label of this nameplate. Currently unused
            - `palette` union, required
              - …
        - `primary_guild` UserPrimaryGuildResponse, required
          - `identity_guild_id` string, snowflake, required
          - `identity_enabled` boolean, nullable, required — whether the user is displaying the primary guild's server tag
          - `tag` string, nullable, required — the text of the user's server tag, limited to 4 characters
          - `badge` string, nullable, required — the server tag badge hash
      - `token` string
      - `url` string, uri

## Other responses

- `429` — Client ratelimited response
- `4XX` — Client error response

## Changes

> 58 revisions in range; 1 could not be searched.

- **2026-06-05** `693bf1f99bba` — 3 breaking
  - added `subschema #1: CRIMSON, subschema #2: BERRY, subschema #3: SKY, subschema #4: TEAL, subschema #5: FOREST, subschema #6: BUBBLE_GUM, subschema #7: VIOLET, subschema #8: COBALT, subschema #9: CLOVER, subschema #10: LEMON, subschema #11: WHITE, subschema #12: BLACK` to the `items/oneOf[#/components/schemas/ApplicationIncomingWebhookResponse]/user/collectibles/oneOf[#/components/schemas/UserCollectiblesResponse]/nameplate/oneOf[#/components/schemas/UserNameplateResponse]/palette` response property `oneOf` list for the response status `200`
  - added `subschema #1: CRIMSON, subschema #2: BERRY, subschema #3: SKY, subschema #4: TEAL, subschema #5: FOREST, subschema #6: BUBBLE_GUM, subschema #7: VIOLET, subschema #8: COBALT, subschema #9: CLOVER, subschema #10: LEMON, subschema #11: WHITE, subschema #12: BLACK` to the `items/oneOf[#/components/schemas/ChannelFollowerWebhookResponse]/user/collectibles/oneOf[#/components/schemas/UserCollectiblesResponse]/nameplate/oneOf[#/components/schemas/UserNameplateResponse]/palette` response property `oneOf` list for the response status `200`
  - added `subschema #1: CRIMSON, subschema #2: BERRY, subschema #3: SKY, subschema #4: TEAL, subschema #5: FOREST, subschema #6: BUBBLE_GUM, subschema #7: VIOLET, subschema #8: COBALT, subschema #9: CLOVER, subschema #10: LEMON, subschema #11: WHITE, subschema #12: BLACK` to the `items/oneOf[#/components/schemas/GuildIncomingWebhookResponse]/user/collectibles/oneOf[#/components/schemas/UserCollectiblesResponse]/nameplate/oneOf[#/components/schemas/UserNameplateResponse]/palette` response property `oneOf` list for the response status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/discord/apis/discord-http-api-preview/changes/guilds/:guild_id/webhooks/get.md)

---

[API](https://skmtc.dev/discord/apis/discord-http-api-preview.md) · [All operations](https://skmtc.dev/discord/apis/discord-http-api-preview/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/discord/discord-http-api-preview/revisions/49efa428e0dd/schema)
