Subscribers
Get in-app notifications feed of subscriber.
- API Overview
- API Rate Limiting
Events
Subscribers
- GETGet subscribers
- POSTCreate subscriber
- POSTBulk create subscribers
- GETGet subscriber
- PUTUpdate subscriber
- DELDelete subscriber
- PUTUpdate subscriber credentials
- DELDelete subscriber credentials by providerId
- PATCHUpdate subscriber online status
- GETGet subscriber preferences
- GETGet subscriber preferences by level
- PATCHUpdate subscriber preference
- PATCHUpdate subscriber global preferences
- GETGet in-app notifications feed of subscriber.
- GETGet unseen in-app notifications count
- POSTMarks a message as read/unread, seen/unseen.
- POSTMarks all messages as read/unread, seen/unseen.
- POSTMark message action as seen
- GETHandle providers oauth redirect
- GETHandle chat oauth
- GET
Topics
Notification
Workflows
Workflow overrides
Workflow groups
Integrations
Layouts
Environments
Changes
Execution details
Feeds
Tenants
Organizations
Messages
API Reference
Subscribers
Get in-app notifications feed of subscriber.
GET
/
v1
/
subscribers
/
{subscriberId}
/
notifications
/
feed
Authorization
string
*
Authorization
Required
string
API key authentication. Allowed headers-- "Authorization: ApiKey <api_key>".
subscriberId
string
*
subscriberId
Required
string
page
number
page
number
limit
number
limit
number
read
boolean
read
boolean
seen
boolean
seen
boolean
payload
string
payload
string
Base64 encoded string of the partial payload JSON object
{
"data": [
{
"_environmentId": "string",
"_feedId": "string",
"_id": "string",
"_messageTemplateId": "string",
"_notificationId": "string",
"_organizationId": "string",
"_subscriberId": "string",
"_templateId": "string",
"channel": "in_app",
"createdAt": "string",
"cta": {
"action": {
"buttons": [
{
"content": "string",
"resultContent": "string",
"type": "primary"
}
],
"result": {
"payload": "object",
"type": "primary"
},
"status": "pending"
},
"data": {
"url": "string"
},
"type": "redirect"
},
"deviceTokens": [
"string"
],
"directWebhookUrl": "string",
"email": "string",
"errorId": "string",
"errorText": "string",
"lastSeenDate": "string",
"overrides": "object",
"payload": "object",
"phone": "string",
"providerId": "string",
"seen": "boolean",
"status": "sent",
"subject": "string",
"subscriber": {
"__v": "number",
"_environmentId": "string",
"_id": "string",
"_organizationId": "string",
"avatar": "string",
"channels": [
{
"_integrationId": "string",
"credentials": {
"channel": "string",
"deviceTokens": [
"string"
],
"webhookUrl": "string"
},
"integrationIdentifier": "string",
"providerId": "slack"
}
],
"createdAt": "string",
"deleted": "boolean",
"email": "string",
"firstName": "string",
"isOnline": "boolean",
"lastName": "string",
"lastOnlineAt": "string",
"locale": "string",
"phone": "string",
"subscriberId": "string",
"updatedAt": "string"
},
"template": {
"_creatorId": "string",
"_environmentId": "string",
"_id": "string",
"_notificationGroupId": "string",
"_organizationId": "string",
"_parentId": "string",
"active": "boolean",
"critical": "boolean",
"data": "object",
"deleted": "boolean",
"deletedAt": "string",
"deletedBy": "string",
"description": "string",
"draft": "boolean",
"name": "string",
"notificationGroup": {
"_environmentId": "string",
"_id": "string",
"_organizationId": "string",
"_parentId": "string",
"name": "string"
},
"preferenceSettings": {
"chat": "boolean",
"email": "boolean",
"in_app": "boolean",
"push": "boolean",
"sms": "boolean"
},
"steps": [
{
"_id": "string",
"_parentId": "object",
"_templateId": "string",
"active": "boolean",
"filters": [
{
"children": [
{
"field": "string",
"operator": "LARGER",
"true": "subscriber",
"value": "string"
}
],
"isNegated": "boolean",
"type": "BOOLEAN",
"value": "AND"
}
],
"name": "string",
"replyCallback": "object",
"shouldStopOnFail": "boolean",
"template": "object",
"uuid": "string"
}
],
"tags": [
"string"
],
"triggers": [
{
"identifier": "string",
"subscriberVariables": [
{
"name": "string"
}
],
"type": "string",
"variables": [
{
"name": "string"
}
]
}
],
"workflowIntegrationStatus": "object"
},
"templateIdentifier": "string",
"title": "string",
"transactionId": "string"
}
],
"hasMore": "boolean",
"page": "number",
"pageSize": "number"
}
Enter your API key in the Authorization field like the example shown below:
E.g ApiKey 18d2e625f05d80e
{
"data": [
{
"_environmentId": "string",
"_feedId": "string",
"_id": "string",
"_messageTemplateId": "string",
"_notificationId": "string",
"_organizationId": "string",
"_subscriberId": "string",
"_templateId": "string",
"channel": "in_app",
"createdAt": "string",
"cta": {
"action": {
"buttons": [
{
"content": "string",
"resultContent": "string",
"type": "primary"
}
],
"result": {
"payload": "object",
"type": "primary"
},
"status": "pending"
},
"data": {
"url": "string"
},
"type": "redirect"
},
"deviceTokens": [
"string"
],
"directWebhookUrl": "string",
"email": "string",
"errorId": "string",
"errorText": "string",
"lastSeenDate": "string",
"overrides": "object",
"payload": "object",
"phone": "string",
"providerId": "string",
"seen": "boolean",
"status": "sent",
"subject": "string",
"subscriber": {
"__v": "number",
"_environmentId": "string",
"_id": "string",
"_organizationId": "string",
"avatar": "string",
"channels": [
{
"_integrationId": "string",
"credentials": {
"channel": "string",
"deviceTokens": [
"string"
],
"webhookUrl": "string"
},
"integrationIdentifier": "string",
"providerId": "slack"
}
],
"createdAt": "string",
"deleted": "boolean",
"email": "string",
"firstName": "string",
"isOnline": "boolean",
"lastName": "string",
"lastOnlineAt": "string",
"locale": "string",
"phone": "string",
"subscriberId": "string",
"updatedAt": "string"
},
"template": {
"_creatorId": "string",
"_environmentId": "string",
"_id": "string",
"_notificationGroupId": "string",
"_organizationId": "string",
"_parentId": "string",
"active": "boolean",
"critical": "boolean",
"data": "object",
"deleted": "boolean",
"deletedAt": "string",
"deletedBy": "string",
"description": "string",
"draft": "boolean",
"name": "string",
"notificationGroup": {
"_environmentId": "string",
"_id": "string",
"_organizationId": "string",
"_parentId": "string",
"name": "string"
},
"preferenceSettings": {
"chat": "boolean",
"email": "boolean",
"in_app": "boolean",
"push": "boolean",
"sms": "boolean"
},
"steps": [
{
"_id": "string",
"_parentId": "object",
"_templateId": "string",
"active": "boolean",
"filters": [
{
"children": [
{
"field": "string",
"operator": "LARGER",
"true": "subscriber",
"value": "string"
}
],
"isNegated": "boolean",
"type": "BOOLEAN",
"value": "AND"
}
],
"name": "string",
"replyCallback": "object",
"shouldStopOnFail": "boolean",
"template": "object",
"uuid": "string"
}
],
"tags": [
"string"
],
"triggers": [
{
"identifier": "string",
"subscriberVariables": [
{
"name": "string"
}
],
"type": "string",
"variables": [
{
"name": "string"
}
]
}
],
"workflowIntegrationStatus": "object"
},
"templateIdentifier": "string",
"title": "string",
"transactionId": "string"
}
],
"hasMore": "boolean",
"page": "number",
"pageSize": "number"
}
Authorizations
Authorization
string
headerrequiredAPI key authentication. Allowed headers-- "Authorization: ApiKey <api_key>".
Path Parameters
subscriberId
string
requiredQuery Parameters
page
number
limit
number
default: 10read
boolean
seen
boolean
payload
string
Base64 encoded string of the partial payload JSON object
Response
200 - application/json
data
object
data.totalCount
number
Total number of notifications available.
data.hasMore
boolean
requiredIndicates if there are more notifications to load.
data.data
object[]
requiredArray of notifications returned in the response.
data.data._id
string
requiredUnique identifier for the notification.
data.data._templateId
string
requiredIdentifier for the template used to generate the notification.
data.data._environmentId
string
requiredIdentifier for the environment where the notification is sent.
data.data._messageTemplateId
string
requiredIdentifier for the message template used.
data.data._organizationId
string
requiredIdentifier for the organization sending the notification.
data.data._notificationId
string
requiredUnique identifier for the notification instance.
data.data._subscriberId
string
requiredUnique identifier for the subscriber receiving the notification.
data.data._feedId
string
requiredIdentifier for the feed associated with the notification.
data.data._jobId
string
requiredIdentifier for the job that triggered the notification.
data.data.createdAt
string | null
Timestamp indicating when the notification was created.
data.data.updatedAt
string | null
Timestamp indicating when the notification was last updated.
data.data.actor
object
Actor details related to the notification, if applicable.
data.data.actor.data
string | null
requiredThe data associated with the actor, can be null if not applicable.
data.data.actor.type
enum<string>
requiredThe type of the actor, indicating the role in the notification process.
Available options:
none, user, system_icon, system_custom data.data.subscriber
object
Subscriber details associated with this notification.
data.data.subscriber._id
string
The internal ID generated by Novu for your subscriber. This ID does not match the subscriberId used in your queries. Refer to subscriberId for that identifier.
data.data.subscriber.firstName
string
The first name of the subscriber.
data.data.subscriber.lastName
string
The last name of the subscriber.
data.data.subscriber.avatar
string
The URL of the subscriber's avatar image.
data.data.subscriber.subscriberId
string
requiredThe identifier used to create this subscriber, which typically corresponds to the user ID in your system.
data.data.transactionId
string
requiredUnique identifier for the transaction associated with the notification.
data.data.templateIdentifier
string | null
Identifier for the template used, if applicable.
data.data.providerId
string | null
Identifier for the provider that sends the notification.
data.data.content
string
requiredThe main content of the notification.
data.data.subject
string | null
The subject line for email notifications, if applicable.
data.data.channel
enum<string>
requiredThe channel through which the notification is sent.
Available options:
in_app, email, sms, chat, push data.data.read
boolean
requiredIndicates whether the notification has been read by the subscriber.
data.data.seen
boolean
requiredIndicates whether the notification has been seen by the subscriber.
data.data.deleted
boolean
requiredIndicates whether the notification has been deleted.
data.data.deviceTokens
string[] | null
Device tokens for push notifications, if applicable.
data.data.cta
object
requiredCall-to-action information associated with the notification.
data.data.cta.type
enum<string>
Available options:
redirect data.data.cta.data
object
requireddata.data.cta.data.url
string
data.data.cta.action
object
data.data.cta.action.status
enum<string>
Available options:
pending, done data.data.cta.action.buttons
object[]
data.data.cta.action.buttons.type
enum<string>
requiredAvailable options:
primary, secondary data.data.cta.action.buttons.content
string
requireddata.data.cta.action.buttons.resultContent
string
data.data.cta.action.result
object
data.data.cta.action.result.payload
object
data.data.cta.action.result.type
enum<string>
Available options:
primary, secondary data.data.status
enum<string>
requiredCurrent status of the notification.
Available options:
sent, error, warning data.data.payload
object
The payload that was used to send the notification trigger.
data.data.overrides
object
Provider-specific overrides used when triggering the notification.
data.pageSize
number
requiredThe number of notifications returned in this response.
data.page
number
requiredThe current page number of the notifications.
Was this page helpful?
{
"data": [
{
"_environmentId": "string",
"_feedId": "string",
"_id": "string",
"_messageTemplateId": "string",
"_notificationId": "string",
"_organizationId": "string",
"_subscriberId": "string",
"_templateId": "string",
"channel": "in_app",
"createdAt": "string",
"cta": {
"action": {
"buttons": [
{
"content": "string",
"resultContent": "string",
"type": "primary"
}
],
"result": {
"payload": "object",
"type": "primary"
},
"status": "pending"
},
"data": {
"url": "string"
},
"type": "redirect"
},
"deviceTokens": [
"string"
],
"directWebhookUrl": "string",
"email": "string",
"errorId": "string",
"errorText": "string",
"lastSeenDate": "string",
"overrides": "object",
"payload": "object",
"phone": "string",
"providerId": "string",
"seen": "boolean",
"status": "sent",
"subject": "string",
"subscriber": {
"__v": "number",
"_environmentId": "string",
"_id": "string",
"_organizationId": "string",
"avatar": "string",
"channels": [
{
"_integrationId": "string",
"credentials": {
"channel": "string",
"deviceTokens": [
"string"
],
"webhookUrl": "string"
},
"integrationIdentifier": "string",
"providerId": "slack"
}
],
"createdAt": "string",
"deleted": "boolean",
"email": "string",
"firstName": "string",
"isOnline": "boolean",
"lastName": "string",
"lastOnlineAt": "string",
"locale": "string",
"phone": "string",
"subscriberId": "string",
"updatedAt": "string"
},
"template": {
"_creatorId": "string",
"_environmentId": "string",
"_id": "string",
"_notificationGroupId": "string",
"_organizationId": "string",
"_parentId": "string",
"active": "boolean",
"critical": "boolean",
"data": "object",
"deleted": "boolean",
"deletedAt": "string",
"deletedBy": "string",
"description": "string",
"draft": "boolean",
"name": "string",
"notificationGroup": {
"_environmentId": "string",
"_id": "string",
"_organizationId": "string",
"_parentId": "string",
"name": "string"
},
"preferenceSettings": {
"chat": "boolean",
"email": "boolean",
"in_app": "boolean",
"push": "boolean",
"sms": "boolean"
},
"steps": [
{
"_id": "string",
"_parentId": "object",
"_templateId": "string",
"active": "boolean",
"filters": [
{
"children": [
{
"field": "string",
"operator": "LARGER",
"true": "subscriber",
"value": "string"
}
],
"isNegated": "boolean",
"type": "BOOLEAN",
"value": "AND"
}
],
"name": "string",
"replyCallback": "object",
"shouldStopOnFail": "boolean",
"template": "object",
"uuid": "string"
}
],
"tags": [
"string"
],
"triggers": [
{
"identifier": "string",
"subscriberVariables": [
{
"name": "string"
}
],
"type": "string",
"variables": [
{
"name": "string"
}
]
}
],
"workflowIntegrationStatus": "object"
},
"templateIdentifier": "string",
"title": "string",
"transactionId": "string"
}
],
"hasMore": "boolean",
"page": "number",
"pageSize": "number"
}