Send Test Notification - Pacifica

POST /api/v1/account/notifications/test

This endpoint sends a test notification to your account. Use it to check that a device or browser receives pushes. The test notification uses only the master preference. Pacifica sends it on every channel that is on in Set notification master preference. Type preferences don’t apply.

Field	Value
`"notification_type"`	`"test"`
`"title"`	`"Pacifica"`
`"body"`	`"Notifications are enabled."`

Pacifica sends a mobile_push test to every active Expo token and a web_push test to every active Web Push subscription on the account. If in_app is on, the test also appears in Get notification history.

Operation Type (for Signing)

Header Field	Type	Content
`"type"`	string	`"send_test_notification"`

Request Body

Field	Type	Need	Description	Example
`”account”`	string	required	User’s wallet address	`42trU9A5…`
`“signature”`	string	required	Cryptographic signature	`5j1Vy9Uq…`
`“timestamp”`	integer	required	Current timestamp in milliseconds	`1716200000000`
`”expiry_window”`	integer	optional	Signature expiry in milliseconds	`30000`
`”agent_wallet”`	string	optional	Agent wallet address	`69trU9A5…`

{
  "account": "42trU9A5...",
  "signature": "5j1Vy9Uq...",
  "timestamp": 1716200000000,
  "expiry_window": 30000
}

You can sign this request with the account key or with an agent wallet.

Signing

This request has no fields of its own. Sign an empty data object:

{"data":{},"expiry_window":30000,"timestamp":1716200000000,"type":"send_test_notification"}

Response

Status 200: Test notification created

{
  "success": true,
  "data": {
    "outbox_id": 81235
  },
  "error": null,
  "code": null
}

Field	Type	Description
`”outbox_id”`	integer	ID of the test notification. It is the `id` in Get notification history and the `notification_id` in a Web Push payload

A 200 response means that Pacifica created the notification. Delivery to each device happens after the response.

Status 400: Invalid request parameters or signature
Status 403: The account doesn’t exist. An account exists after its first deposit
Status 409: No channel is on in the master preference

{
  "success": false,
  "data": null,
  "error": "Notifications are disabled",
  "code": 409,
  "error_id": "notifications_disabled"
}

Status 429: Rate limit exceeded
Status 500: Internal server error

Code Example (Python)

import requests

payload = {
    "account": "42trU9A5...",
    "signature": "5j1Vy9Uq...",
    "timestamp": 1716200000000
}

response = requests.post(
    "/api/v1/account/notifications/test",
    json=payload,
    headers={"Content-Type": "application/json"}
)

data = response.json()