> ## Documentation Index
> Fetch the complete documentation index at: https://docs.platform.arb.inc/llms.txt
> Use this file to discover all available pages before exploring further.

# Send web push notification to subscription

> Sends a web push notification to a specific subscription by ID. This endpoint is used internally by other services to deliver notifications to user browsers. Requires `push.notifications.creator` permission.



## OpenAPI

````yaml api-reference/push.yaml post /internal/send-web-push-to-subscription
openapi: 3.0.3
info:
  title: push
  description: >-
    The Push service keeps track of which user browsers have signed up to
    receive notifications and how to reach them using VAPID. Other services tell
    it when a notification should be sent, and it delivers that message directly
    to the user's browser.
  version: 1.0.0
servers:
  - url: https://push.platform.arb.inc
security: []
tags:
  - name: /
  - name: demo
  - name: internal
  - name: vapid-keys
  - name: web-push
paths:
  /internal/send-web-push-to-subscription:
    post:
      tags:
        - internal
      summary: Send web push notification to subscription
      description: >-
        Sends a web push notification to a specific subscription by ID. This
        endpoint is used internally by other services to deliver notifications
        to user browsers. Requires `push.notifications.creator` permission.
      operationId: sendWebPushToSubscription
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - subscriptionID
              properties:
                subscriptionID:
                  type: string
                  description: Unique identifier for the web push subscription
                  example: 3f8c7e4d-2a1b-4c9d-8e7f-6a5b4c3d2e1f
                title:
                  type: string
                  description: Title of the push notification
                  example: New Message
                body:
                  type: string
                  description: Body text of the push notification
                  example: You have received a new message from the court
                icon:
                  type: string
                  description: URL to an icon image for the notification
                  example: https://platform.arb.inc/icons/notification.png
                url:
                  type: string
                  description: URL to navigate to when the notification is clicked
                  example: https://platform.arb.inc/cases/2025-08-00292
                data:
                  type: object
                  description: Additional custom data to include with the notification
                  additionalProperties: true
      responses:
        '200':
          description: Notification sent successfully
          content:
            text/plain:
              schema:
                type: string
                example: Notification sent successfully
        '404':
          description: Subscription not found
          content:
            text/plain:
              schema:
                type: string
                example: Subscription not found
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      description: access token
      scheme: bearer
      bearerFormat: JWT

````