Skip to main content
POST
/
push-notification
curl --request POST \
  --url https://activitysmith.com/api/push-notification \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "New subscription 💸",
  "message": "Customer upgraded to Pro plan"
}
'
{
  "success": true,
  "devices_notified": 2,
  "users_notified": 1,
  "timestamp": "2025-08-12T12:00:00.000Z"
}

Authorizations

​
Authorization
string
header
required

Required. Include Authorization: Bearer ask_123456789 in every request. Replace ask_123456789 with your API key.

Body

application/json
​
title
string
required
​
message
string
​
subtitle
string
​
media
string<uri>

Optional HTTPS URL for an image, audio file, or video that users can preview or play when they expand the notification. If redirection is omitted, tapping the notification opens this URL. Cannot be combined with actions.

Pattern: ^https://
​
redirection
string<uri>

Optional HTTPS URL opened when user taps the notification body. Overrides the default tap target from media when both are provided.

Pattern: ^https://
​
actions
object[]

Optional interactive actions shown when users expand the notification. Cannot be combined with media.

Maximum array length: 4
​
payload
object
​
badge
integer
​
sound
string
​
target
object

Response

Push notification sent

​
success
boolean
required
​
timestamp
string<date-time>
required
​
devices_notified
integer
​
users_notified
integer
​
effective_channel_slugs
string[] | null