Get started

Quickstart

Send your first message with cURL or Node.js, then pick it up on your phone.

Send your first message

Create a channel

Open appkeepr, create a workspace and add a signups channel. Click Subscribe to follow it in your Inbox.

Create an API token

In Settings → API tokens, click Create token. Set APPKEEPR_API_TOKEN on your server.

Keep your token private

Copy the token before closing the dialog. Keep it out of browser code.

Send a message

Send from your terminal
curl https://appkeepr.com/api/messages \
  -H "Authorization: Bearer $APPKEEPR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: signup-1042" \
  -d '{"channel":"signups","body":"Ada created an account.","title":"New signup","icon":"👋"}'

See your message

A successful request returns:

Accepted message
{ "messageId": "0f6211b8-9d26-4af1-83b2-a8cbd64a0378", "outcome": "created" }

Your message is in signups. Open the channel on the web or sign in on your phone with the same account and workspace.

Download on the App Store

Try a push notification

Enable notifications on your phone and subscribe to signups, then send another message with a new idempotency key. Push starts with new messages; older ones stay in your Inbox.

Add project context

Create a checkout project in Projects, then add project: "checkout" to your next message. Use a new idempotency key for each new event.

On this page