Sign in

v1

latestOpenAPI 3.1.02026-07-26497885.9 KB

Message history

View which subscriptions received a particular message

post/notifications/{message_id}/history

Path parameters

message_idstring required

The identifier of the message in UUID v4 format. Get this id in the response of your Create Message API request, the View Messages API, and in your OneSignal dashboard Message Reports.

Headers

Authorizationstring required

Your App API key with prefix Key . See Keys & IDs.

Request body

app_idstring required

Your OneSignal App ID in UUID v4 format. See Keys & IDs.

eventsstring required

Specifies the type of event to retrieve. sent — retrieves all subscriptions sent the specified message. Note: sent events are not recorded for messages targeting fewer than 1,000 recipients. clicked — retrieves all subscriptions that interacted with the message. Note: There isn't a recipient count threshold for tracking clicked event.

emailstring

The email address in which to deliver the report.

Response

Accepted. The history-export job was enqueued. The export is delivered asynchronously to the configured S3 destination.

successboolean
destination_urlstring

Example response

{
  "success": true,
  "destination_url": "https://onesignal-aws-link.csv"
}