App Management

What is an App?

A todoke “app” is the management unit for Push notifications. One app corresponds to one service (website). Each app has its own independent VAPID key pair, subscribers, and API keys.

Creating an App

1. Log in to the dashboard and click “Create New App”
2. Enter an app name and click “Create”

A P-256 VAPID key pair is automatically generated upon creation. The private key is encrypted with AES-GCM and stored server-side, so only the public key is shown in the dashboard.

VAPID Public Key

Use the value displayed in “VAPID Public Key” on the app detail screen in your frontend Service Worker implementation.

// Frontend: specify as applicationServerKey for Push subscription
const subscription = await registration.pushManager.subscribe({
  userVisibleOnly: true,
  applicationServerKey: "BNfhTEO47qSR...", // value shown in the dashboard
});

Caution

The VAPID public key cannot be changed after the app is created, as this would invalidate existing subscribers. If you need a new key, create a new app.

Statistics

The following statistics are available on the app detail screen. To retrieve them directly from the API, call GET /api/v1/apps/:id/stats (with a full scope key or a dashboard session).

Item	Response field name	Description
Active Subscribers	activeSubscribers	Number of currently valid Push subscriptions
Total Sent	totalSent	Total number of notifications sent since app creation
Failed	totalFailed	Number of failed notifications (invalid subscriptions, errors, etc.)
This Month’s Sends	monthlySent	Number of sends in the current month (counted against plan limit)

App Limit

The Free plan allows creating up to 1 app. Attempting to create a new app once the limit is reached returns 403 PLAN_LIMIT_EXCEEDED (with upgrade_url).

Deleting an App

Deleting an app cascades to remove all associated API keys, subscribers, monthly usage, and notification logs.

Danger

Deleting an app cannot be undone. Deleted API keys, subscriber data, and notification logs cannot be recovered. Back up any data you need (statistics, logs, etc.) before proceeding.

See Error Codes and Limits for error code details.