> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bleed.bot/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhook

> Relay messages through a webhook with a custom username and avatar.

## What is a webhook?

A webhook is a way to post a message with a custom username and avatar to a channel.

<Info>
  Webhooks support [embeds](/resources/scripting) with dynamic
  [variables](/resources/scripting/variables).
</Info>

## Creating a webhook

You can use the `webhook create` command to create a webhook.

<Info>The webhook identifier is important for referencing the webhook in other commands.</Info>

<CodeGroup>
  ```javascript Syntax theme={null}
  ,webhook create (name)
  ```

  ```javascript Example theme={null}
  ,webhook create daddyhook
  ```
</CodeGroup>

<br />

<Frame>
  <img src="https://mintcdn.com/bleed/2xss_MWCdGi-bEKc/images/miscellaneous/webhook/create.png?fit=max&auto=format&n=2xss_MWCdGi-bEKc&q=85&s=080a1befc7b518464d2aeb0fc239cee4" width="653" height="189" data-path="images/miscellaneous/webhook/create.png" />
</Frame>

### Customizing the webhook

If you want to change the webhook's username or avatar, you can open the **Webhooks** tab in the channel's integrations settings.

<Frame>
  <img src="https://mintcdn.com/bleed/2xss_MWCdGi-bEKc/images/miscellaneous/webhook/customize.gif?s=09c8cc7badc589c4bc5a69ab1c2f1e9f" width="1026" height="607" data-path="images/miscellaneous/webhook/customize.gif" />
</Frame>

## Sending a message

After creating a webhook, you can use the `webhook send` command to send a message.

<Info>
  If you've forgotten the identifier, you can use the `webhook list` command to
  view all webhooks.
</Info>

<Tip>You can use the `--add` flag to add another embed to the message.</Tip>

<CodeGroup>
  ```javascript Syntax theme={null}
  ,webhook send (identifier) (message) [--add (embed code)]
  ```

  ```javascript Example theme={null}
  ,webhook send 1cc8rax hello
  ,webhook send 1cc8rax {embed}$v{title: hello} --add {embed}$v{title: hi}
  ```
</CodeGroup>

<br />

<Frame>
  <img src="https://mintcdn.com/bleed/2xss_MWCdGi-bEKc/images/miscellaneous/webhook/send.png?fit=max&auto=format&n=2xss_MWCdGi-bEKc&q=85&s=dd6e8fd1cfa048b113de99bdf55cacb0" width="617" height="387" data-path="images/miscellaneous/webhook/send.png" />
</Frame>

### Editing the message

You can use the `webhook edit` command to edit a message sent by a webhook.

<CodeGroup>
  ```javascript Syntax theme={null}
  ,webhook edit (message link) (new message)
  ```

  ```javascript Example theme={null}
  ,webhook edit discord.com/.../ hello world
  ```
</CodeGroup>

<br />

<Frame>
  <img src="https://mintcdn.com/bleed/2xss_MWCdGi-bEKc/images/miscellaneous/webhook/edit.png?fit=max&auto=format&n=2xss_MWCdGi-bEKc&q=85&s=43774bf86369f668460e80127397d260" width="629" height="372" data-path="images/miscellaneous/webhook/edit.png" />
</Frame>

## Related commands

<AccordionGroup>
  <Accordion title="Deleting a webhook">
    You can use the `webhook delete` command to delete a webhook.

    <CodeGroup>
      ```javascript Syntax theme={null}
      ,webhook delete (identifier)
      ```

      ```javascript Example theme={null}
      ,webhook delete 1cc8rax
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="Viewing all webhooks">
    You can use the `webhook list` command to view all webhooks.
  </Accordion>
</AccordionGroup>