Get started
Quickstart
Your first message on your phone in five minutes.
By the end of this page, your phone will have received a push notification that you sent yourself. You need the Packlets app and a terminal.
1. Create a packlet
A packlet is the connection between one of your tools and Packlets. Create one in the app:
- In the Channels tab, tap the plus at the top left.
- Choose Messages and tap Continue.
- Enter a name, for example "Test", and pick an avatar.
- Tap Create.

What should reach you in Packlets?
You can always connect more later.
IntegrationsTools with a Slack, Discord or ntfy option send to Packlets without code.ContinueLeave the webhook URL field empty. You only need it once your tool should react to buttons.
2. Save the key
Packlets now shows the key of your packlet. It starts with pk_ and is the password your tool uses to send messages.
Important: You only see the key this one time. Copy it now. If it gets lost, you create a new one in the packlet's settings.
Store it in your terminal as an environment variable. That keeps it out of your code:
export PACKLETS_KEY="pk_…"3. Send your first message
The app is now waiting for the first message. Send it:
curl https://api.packlets.app/v1/push \
-H "Authorization: Bearer $PACKLETS_KEY" \
-H "Content-Type: application/json" \
-d '{"title":"Hello","text":"My tool is connected"}'The response contains the ID of the message:
{ "message_id": "5b0c1a52-7c1e-4a43-9d0b-2f6f0c7d1e11" }4. Done
The app shows Connected!, and the message is in your new channel. If the app is in the background, it arrives as a push.

Test
Today, 9:41
Hello
My tool is connected
You can now add the same three lines to any script: at the end of a backup, in a cron job, in an error handler.
If it doesn't work
| What you see | Cause |
|---|---|
401 with invalid_key | The key is wrong. Check with echo $PACKLETS_KEY that it's complete. |
400 with invalid_body | text is missing from the JSON, or it's empty. |
200, but no push | The message is there, only the push is missing: open the channel and check that notifications are allowed for Packlets. |
More in Troubleshooting.
What's next
- Understand what you just built: How Packlets works.
- Get more out of the message: Send a message and Buttons.
- Have an AI add the call for you: Build with AI.
- Ready-made functions for Python and TypeScript: Ready-made code.