Channel: send messages
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
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 or the Slack address instead, if the tool offers one.
Quick test
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:
| 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 high |
flags: 4096 (silent message) | priority silent |
Link buttons in components | up to 3 buttons 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 applies as for POST /v1/push. |
Limits
- Packlets doesn't accept files (uploads with
multipart/form-data). Images go as a link inembeds[].image. - Buttons only open links. Buttons that reply to your tool are available with
POST /v1/pushand a webhook. - Editing or deleting messages (
PATCH/DELETEon the webhook address) isn't supported.