Channel: send messages

No code: Discord URL

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

Open as Markdown

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:

AreaTools
MonitoringUptime Kuma, Grafana, Healthchecks.io, Gatus, Netdata
MediaSonarr, Radarr, Lidarr, Jellyfin, Plex (via Tautulli), Overseerr
ServersProxmox, Watchtower, Unraid, TrueNAS
Code and deploysGitHub Actions, GitLab, Coolify
Automationn8n, 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

Shell
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:

DiscordIn Packlets
contentMessage text
**bold**, # Heading, - Itemas 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[].urlMessage link
embeds[].descriptionParagraph
embeds[].fields"Name: Value" list
embeds[].footer.textsmall paragraph at the end
embeds[].image or thumbnailMessage image
embeds[].color in redpriority high
flags: 4096 (silent message)priority silent
Link buttons in componentsup 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

StatusResponseMeaning
204emptySaved, the push is on its way.
200JSON with idSame as 204, when the address ends with ?wait=true.
400JSON with code 50006No text found, neither in content nor in embeds.
401JSON with invalid_keyKey is wrong or the packlet was removed.
429JSON with rate_limitedToo 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 in embeds[].image.
  • Buttons only open links. Buttons that reply to your tool are available with POST /v1/push and a webhook.
  • Editing or deleting messages (PATCH/DELETE on the webhook address) isn't supported.