A valid request URL is required to generate request examples{
"id": "Hf2kP9wQ7mXc3LrN8vBd5g",
"platform": "ios",
"bundle_id": "com.example.phone",
"apns_team_id": "ABCDE12345",
"apns_key_id": "ABC123DEFG",
"apns_environment": "sandbox",
"delivery_mode": "",
"managed_refresh_push": "",
"created_at": "2026-11-02T08:20:00Z"
}Apps
Register an app
Registers an app with its push credentials. iOS apps need the
apns_* fields, Android apps need the fcm_* fields, and web apps
need vapid_subject. A tenant can have one web app. Without
vapid_private_key_pem, pgw generates the web app’s VAPID key. pgw
checks the format of each credential and encrypts it at rest, but doesn’t
contact Apple or Google.
POST
/
apps
A valid request URL is required to generate request examples{
"id": "Hf2kP9wQ7mXc3LrN8vBd5g",
"platform": "ios",
"bundle_id": "com.example.phone",
"apns_team_id": "ABCDE12345",
"apns_key_id": "ABC123DEFG",
"apns_environment": "sandbox",
"delivery_mode": "",
"managed_refresh_push": "",
"created_at": "2026-11-02T08:20:00Z"
}Body
application/json
Response
The app was registered.