---
title: "Start a Web Push installation"
method: POST
path: "/integrations/web_push/installations/start"
tags: ["web_push"]
---

# Start a Web Push installation

`POST /integrations/web_push/installations/start`

Initiates the installation flow for a Web Push integration. This is the first step in a multi-step installation process where user authorization or external service configuration may be required.

## Response `201`

Created

- WebPushStartInstallationResponse
  - `auth_token` string, required — Auth secret returned from PushSubscription.getKey('auth').
  - `public_key` string, required — VAPID public key generated for this web push installation.

---

[API](https://skmtc.net/magicbell/apis/magicbell-api.md) · [All operations](https://skmtc.net/magicbell/apis/magicbell-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/magicbell/magicbell-api/revisions/8b99dca11019/schema)