# No code: Discord URL

Tools with a Discord option send to Packlets with this URL. No code and no Discord account.

Many tools have a setting called "Discord notification" or "Discord webhook". There, instead of a Discord address, you enter the Discord address of your packlet. Packlets accepts the message as if Packlets were Discord and sends it as a push to your phone.

You don't write any code and you don't need a Discord account.

## Connect in the app

When connecting, tap **Integrations** and choose **Discord**. Name and animal are already filled in. Instead of code, Packlets then shows the finished address to copy. You enter it in your tool where it asks for the Discord address.

## Your address

```text
https://api.packlets.app/v1/discord/<PACKLETS_KEY>
```

Replace `<PACKLETS_KEY>` with the key of your packlet, the one that starts with `pk_`.

> The key is part of the address because these tools can't send their own header. So treat the whole address like a password. If you create a new key in the app, the old address stops working immediately.

## Where this works

Anywhere you can enter an arbitrary Discord webhook address. For example:

| Area | Tools |
|---|---|
| Monitoring | Uptime Kuma, Grafana, Healthchecks.io, Gatus, Netdata |
| Media | Sonarr, Radarr, Lidarr, Jellyfin, Plex (via Tautulli), Overseerr |
| Servers | Proxmox, Watchtower, Unraid, TrueNAS |
| Code and deploys | GitHub Actions, GitLab, Coolify |
| Automation | n8n, Make, Home Assistant |

Some tools check that the address starts with `https://discord.com/api/webhooks/`. That won't work there. Use the [ntfy address](https://packlets.app/en/docs/ntfy.md) or the [Slack address](https://packlets.app/en/docs/slack.md) instead, if the tool offers one.

## Quick test

```bash
curl https://api.packlets.app/v1/discord/<PACKLETS_KEY> \
  -H "Content-Type: application/json" \
  -d '{"content":"**Backup** failed on [server-1](https://status.example.com)"}'
```

Like Discord, Packlets answers with `204` and no content. In the packlet's activity log, the call shows up with "Discord:" in front.

## What Packlets understands

Packlets understands the usual Discord formats and turns them into a normal [message](https://packlets.app/en/docs/senden.md):

| Discord | In Packlets |
|---|---|
| `content` | Message text |
| `**bold**`, `# Heading`, `- Item` | as in Packlets |
| `[Label](https://…)` | Label in the text. The first link becomes the message's link. |
| `*italic*`, `~~strikethrough~~`, `` `code` ``, `\|\|spoiler\|\|` | text only |
| Mentions like `@everyone` or `<@123>` | dropped |
| Timestamps like `<t:1700000000:R>` | date and time |
| `embeds[].title` (otherwise `author.name`) | Title; further embeds as a bold line |
| `embeds[].url` | Message link |
| `embeds[].description` | Paragraph |
| `embeds[].fields` | "Name: Value" list |
| `embeds[].footer.text` | small paragraph at the end |
| `embeds[].image` or `thumbnail` | Message image |
| `embeds[].color` in red | [priority](https://packlets.app/en/docs/push.md) `high` |
| `flags: 4096` (silent message) | priority `silent` |
| Link buttons in `components` | up to 3 [buttons](https://packlets.app/en/docs/knoepfe.md) that open the link |
| Form with `payload_json=<json>` | same as JSON |

Packlets ignores `username`, `avatar_url` and `tts`; name and image come from the packlet. Texts that are too long are shortened, and links without `https` are dropped.

## Responses

| Status | Response | Meaning |
|---|---|---|
| `204` | empty | Saved, the push is on its way. |
| `200` | JSON with `id` | Same as `204`, when the address ends with `?wait=true`. |
| `400` | JSON with `code` `50006` | No text found, neither in `content` nor in `embeds`. |
| `401` | JSON with `invalid_key` | Key is wrong or the packlet was removed. |
| `429` | JSON with `rate_limited` | Too many calls. The same [limit](https://packlets.app/en/docs/api.md#rate-limit) applies as for `POST /v1/push`. |

## Limits

- Packlets doesn't accept files (uploads with `multipart/form-data`). Images go as a link in `embeds[].image`.
- Buttons only open links. Buttons that reply to your tool are available with [`POST /v1/push`](https://packlets.app/en/docs/knoepfe.md) and a [webhook](https://packlets.app/en/docs/webhook.md).
- Editing or deleting messages (`PATCH`/`DELETE` on the webhook address) isn't supported.
