Get started

Quickstart

Send a message from your terminal and see it arrive in Ripple. It takes one key and one command.

Copy a send key

A send key lets a script post messages to one source, and nothing else. A source is where messages show up. Every account starts with one, Inbox, so that's where this message goes.

In Ripple's sidebar, open Inbox's menu and choose Copy send key. Then set it in your terminal:

export RIPPLE_KEY=paste-your-key-here

Tip

In a real script, keep the key with your other secrets, such as your CI's secret settings or a .env file you don't commit.

Send a message

curl https://api.ripplepush.com/v1/send \
  -H "Authorization: Bearer $RIPPLE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Hello from Ripple",
    "body": "The first of many."
  }'

export RIPPLE_KEY=$RIPPLE_KEY
ripple send --title "Hello from Ripple" "The first of many."

Send toYour sources…

Ripple answers 202 Accepted with a receipt:

{
  "status": "accepted",
  "messageId": "msg_426dd54d815b4bfaaf0940b606cd0806",
  "source": { "kind": "system", "id": "src_9fddbdcb785848c6b10b068facd32d87", "label": "Inbox" },
  "receivedAt": "2026-10-02T12:00:01.000Z"
}

Find it in Ripple

Result

“Hello from Ripple” is at the top of Inbox, unread.

Accepted means Ripple saved the message. Whether your phone or computer alerts depends on your notification settings, so a message can also arrive quietly.

Next steps

Calling Ripple from code? The language examples show a send in JavaScript and Python.