Push Notifications

Device registration, immediate sends, and travel-time-adjusted scheduled pushes.

Endpoints

POST /v1/notifications/devices Register a device

POST /v1/notifications/send Send an immediate push

POST /v1/notifications/schedule Schedule a future push

DELETE /v1/notifications/scheduled/{id} Cancel a scheduled push

Register a device

HTTP
POST /v1/notifications/devices

Field	Type	Description
user_id	string	required
platform	string	ios or android.
token	string	FCM token (Android) or APNS device token (iOS).
app_version	string?	Your app's version, for cohort analytics.
tags	array?	Additional ANH tags for routing.

Behind the scenes, ChronaPilot registers the device with Azure Notification Hubs and tracks the resulting anh_registration_id against the user.

Send an immediate push

HTTP
POST /v1/notifications/send

JSON
{
  "user_id": "usr_1abc2def3ghi",
  "title": "Time to leave",
  "body": "Heavy traffic — leave now to arrive on time.",
  "data": { "event_id": "evt_1abc2def3ghi", "deep_link": "chronapilot://event/evt_1abc2def3ghi" },
  "category": "departure",
  "sound": "departure-default"
}

Schedule a future push

HTTP
POST /v1/notifications/schedule

Two scheduling modes:

Absolute — send_at: "2026-05-22T14:00:00-07:00"
Travel-adjusted — relative_to_event: { event_id, offset_minutes_before_departure }. The fire time updates automatically as the departure window shifts.

JSON
{
  "user_id": "usr_1abc2def3ghi",
  "title": "Leaving in 10 minutes",
  "body": "Smile Dental — 28 min drive, moderate traffic.",
  "relative_to_event": {
    "event_id": "evt_1abc2def3ghi",
    "offset_minutes_before_departure": 10
  }
}

Cancel a scheduled push

HTTP
DELETE /v1/notifications/scheduled/{id}

Reference implementation

curl https://api.chronapilot.com/v1/notifications/send \ -X POST \ -H "Authorization: Bearer sk_test_4eC39HqLyjWDarjtT1zdp7dc" \ -H "Chronapilot-Version: 2026-05-20" \ -H "Content-Type: application/json" \ -d '{ "user_id": "usr_1abc2def3ghi", "title": "Time to leave", "body": "Heavy traffic \u2014 leave now." }'

import ChronaPilot from '@chronapilot/node'; const cp = new ChronaPilot('sk_test_4eC39HqLyjWDarjtT1zdp7dc'); const result = await cp.notifications.send({ user_id: 'usr_1abc2def3ghi', title: 'Time to leave', body: 'Heavy traffic \u2014 leave now.' });

import chronapilot chronapilot.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc' result = chronapilot.Notification.send( user_id='usr_1abc2def3ghi', title='Time to leave', body='Heavy traffic — leave now.', )