Push notifications

This guide pushes a notification from an app, reads it in ego, and lists the app’s pushed notifications from the API.

Notifications work in the app today. The API steps that push and list notifications are in preview.

Prerequisites

An ego account with the app running. See the project README to run it locally.
A token that carries the notifications:write and notifications:read scopes. Grant them on the consent screen.

Push the notification

The app pushes a notification with notifications:write. Give it a title, a body, and a type to categorize it.

curl https://api.myego.dev/api/notifications \
  -H "Authorization: Bearer $EGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Backup complete",
    "body": "The nightly backup finished in 4m12s.",
    "type": "backup",
    "data": { "durationMs": 252000 }
  }'

The call returns the notification’s id:

{ "id": "k1799wxyz" }

Read it in ego

Open the app and go to Notifications. The pushed notification shows its title, body, and type. Reading it there marks it read.

List what the app pushed

The app lists its own pushed notifications with notifications:read:

curl https://api.myego.dev/api/notifications \
  -H "Authorization: Bearer $EGO_API_KEY"

The response holds the app’s notifications under data:

{
  "data": [
    {
      "_id": "k1799wxyz",
      "title": "Backup complete",
      "body": "The nightly backup finished in 4m12s.",
      "type": "backup",
      "data": { "durationMs": 252000 },
      "createdAt": 1735000000000
    }
  ]
}

An app sees only the notifications it pushed. ego also emits system events to the owner’s inbox — approval.created, approval.resolved, grant.revoked, and connection.error — which never appear in this list.

Get Started

Guides

Push notifications

Prerequisites

Push the notification

Read it in ego

List what the app pushed

Next steps

Request approvals

API reference

​Prerequisites

​Push the notification

​Read it in ego

​List what the app pushed

​Next steps

Request approvals

API reference

Prerequisites

Push the notification

Read it in ego

List what the app pushed

Next steps