Quickstart

Create a project, copy your environment variables and send your first Tinyping event with curl, JavaScript or Python.

You need a Tinyping account and about two minutes.

Create a project. A project is one app, server or script that sends alerts. Create it on the Projects page.
Create a token on the project page. Copy it right away, because it is shown only once.
Copy the environment variable from the project page and paste it into your .env file.
Send an event with one of the examples below.

Your .env file looks like this:

.env

TINYPING_TOKEN=your-token

Warning

Keep the token secret and out of git. Anyone who has it can send alerts to your project.

Send your first event

curl https://api.tinyping.app/v1/events \
  -H "Authorization: Bearer $TINYPING_TOKEN" \
  -d title="New sign-up" \
  -d body="ada@example.com started a trial"

See it arrive

A 201 response with an id means Tinyping stored the event.

JSON

{ "id": "3f2b8c1e-0000-0000-0000-000000000000", "createdAt": "2026-01-01T12:00:00.000Z" }

The event appears in your inbox. It also arrives as a push notification on every device that has alerts on. If your phone is not set up yet, read Phone setup.

Send your first event

See it arrive

Know about your next sign-up the second it happens