---
title: "Puts push in send queue. Push body should be any descendant of `/components/schemas/PushNotificationBase`"
method: POST
path: "/enqueue"
---

# Puts push in send queue. Push body should be any descendant of `/components/schemas/PushNotificationBase`

`POST /enqueue`

## Request body

- union
  - PushNotificationLightningInvoicePaid — payload for push notification delivered to phone
    - `type` 1, required — type: * `1` - Your lightning invoice was paid * `2` - New transaction to one of your addresses * `3` - New unconfirmed transaction to one of your addresses * `4` - Transaction confirmed * `5` - Arbitrary text message
    - `token` string, required
    - `os` 'android' | 'ios', required
    - `badge` integer
    - `level` 'transactions', required
    - `sat` integer, required — amount of satoshis
    - `hash` string, required — hash of specific ln invoice preimage
    - `memo` string, required — text attached to bolt11
  - PushNotificationOnchainAddressGotPaid — payload for push notification delivered to phone
    - `type` 2, required — type: * `1` - Your lightning invoice was paid * `2` - New transaction to one of your addresses * `3` - New unconfirmed transaction to one of your addresses * `4` - Transaction confirmed * `5` - Arbitrary text message
    - `token` string, required
    - `os` 'android' | 'ios', required
    - `badge` integer
    - `level` 'transactions', required
    - `sat` integer, required — amount of satoshis
    - `address` string, required — user's onchain address that has incoming transaction
    - `txid` string, required — txid of the transaction where this address is one of the outputs
  - PushNotificationOnchainAddressGotUnconfirmedTransaction — payload for push notification delivered to phone
    - `type` 3, required — type: * `1` - Your lightning invoice was paid * `2` - New transaction to one of your addresses * `3` - New unconfirmed transaction to one of your addresses * `4` - Transaction confirmed * `5` - Arbitrary text message
    - `token` string, required
    - `os` 'android' | 'ios', required
    - `badge` integer
    - `level` 'transactions', required
    - `sat` integer, required — amount of satoshis
    - `address` string, required — user's onchain address that has incoming transaction
    - `txid` string, required — txid of the transaction where this address is one of the outputs
  - PushNotificationTxidGotConfirmed — payload for push notification delivered to phone
    - `type` 4, required — type: * `1` - Your lightning invoice was paid * `2` - New transaction to one of your addresses * `3` - New unconfirmed transaction to one of your addresses * `4` - Transaction confirmed * `5` - Arbitrary text message
    - `token` string, required
    - `os` 'android' | 'ios', required
    - `badge` integer
    - `level` 'transactions', required
    - `txid` string, required — txid of the transaction that got confirmed

## Response `200`

OK

## Changes

> 18 revisions in range; 1 could not be searched.

- **2023-04-03** `808214bd6431` — 4 info
  - added the new `5.00` enum value to the request property `oneOf[#/components/schemas/PushNotificationLightningInvoicePaid]/allOf[#/components/schemas/PushNotificationBase]/type`
  - added the new `5.00` enum value to the request property `oneOf[#/components/schemas/PushNotificationOnchainAddressGotPaid]/allOf[#/components/schemas/PushNotificationBase]/type`
  - added the new `5.00` enum value to the request property `oneOf[#/components/schemas/PushNotificationOnchainAddressGotUnconfirmedTransaction]/allOf[#/components/schemas/PushNotificationBase]/type`
  - added the new `5.00` enum value to the request property `oneOf[#/components/schemas/PushNotificationTxidGotConfirmed]/allOf[#/components/schemas/PushNotificationBase]/type`
- **2021-01-01** `8a2b8b668f4c` — 1 info
  - endpoint added
- **2020-07-12** `2636f89e6b75` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/bluewallet/apis/groundcontrol-push-server-api/changes/enqueue/post.md)

---

[API](https://skmtc.dev/bluewallet/apis/groundcontrol-push-server-api.md) · [All operations](https://skmtc.dev/bluewallet/apis/groundcontrol-push-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bluewallet/groundcontrol-push-server-api/revisions/346c22793d63/schema)