Skip to main content
POST
/
push-notification
Node
import ActivitySmith from "activitysmith";

const activitysmith = new ActivitySmith({
  apiKey: process.env.ACTIVITYSMITH_API_KEY,
});

await activitysmith.notifications.send({
  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 or shortcuts://run-shortcut?name=... URL opened when the user taps the notification body. Use shortcuts://run-shortcut?name=... to run a specific iPhone Shortcut that already exists on the user's device. Overrides the default tap target from media when both are provided.

Pattern: ^(https|shortcuts)://
​
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