Update subscriber

Used to update the subscriber entity with new information

Enter your API key in the Authorization field like the example shown below:

E.g ApiKey 18d2e625f05d80e

Authorizations

Authorization

string

header

required

API key authentication. Allowed headers-- "Authorization: ApiKey <api_key>".

Path Parameters

subscriberId

string

required

Body

application/json

avatar

string

The avatar URL of the subscriber.

channels

object[]

An array of communication channels for the subscriber.

Show child attributes

channels.credentials

object

required

Credentials for the channel.

Show child attributes

channels.credentials.deviceTokens

string[]

An array of device tokens for push notifications.

channels.credentials.webhookUrl

string

The URL for the webhook associated with the channel.

channels.providerId

enum<string>

required

The ID of the chat or push provider.

Available options:

slack,

discord,

msteams,

mattermost,

ryver,

zulip,

grafana-on-call,

getstream,

rocket-chat,

whatsapp-business,

fcm,

apns,

expo,

one-signal,

pushpad,

push-webhook,

pusher-beams

channels.integrationIdentifier

string

An optional identifier for the integration.

data

object

Custom data associated with the subscriber. Can contain any additional properties.

email

string

The email address of the subscriber.

firstName

string

The first name of the subscriber.

lastName

string

The last name of the subscriber.

locale

string

The locale of the subscriber, for example "en-US".

phone

string

The phone number of the subscriber.

Response

200 - application/json

data

object

Show child attributes

data._environmentId

string

required

The unique identifier of the environment associated with this subscriber.

data._organizationId

string

required

The unique identifier of the organization to which the subscriber belongs.

data.createdAt

string

required

The timestamp indicating when the subscriber was created, in ISO 8601 format.

data.deleted

boolean

required

Indicates whether the subscriber has been deleted.

data.subscriberId

string

required

The identifier used to create this subscriber, which typically corresponds to the user ID in your system.

data.updatedAt

string

required

The timestamp indicating when the subscriber was last updated, in ISO 8601 format.

data.__v

number

The version of the subscriber document.

data._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.avatar

string

The URL of the subscriber's avatar image.

data.channels

object[]

An array of channel settings associated with the subscriber.

Show child attributes

data.channels._integrationId

string

required

The unique identifier of the integration associated with this channel.

data.channels.credentials

object

required

Credentials payload for the specified provider

Show child attributes

data.channels.credentials.alertUid

string

Alert UID for Grafana on-call webhook payload.

data.channels.credentials.channel

string

Channel specification for Mattermost chat notifications.

data.channels.credentials.deviceTokens

string[]

Contains an array of the subscriber device tokens for a given provider. Used on Push integrations.

data.channels.credentials.externalUrl

string

Link to upstream details property for Grafana on-call webhook.

data.channels.credentials.imageUrl

string

Image URL property for Grafana on-call webhook.

data.channels.credentials.state

string

State property for Grafana on-call webhook.

data.channels.credentials.title

string

Title to be used with Grafana on-call webhook.

data.channels.credentials.webhookUrl

string

Webhook URL used by chat app integrations. The webhook should be obtained from the chat app provider.

data.channels.providerId

enum<string>

required

The provider identifier for the credentials

Available options:

slack,

discord,

msteams,

mattermost,

ryver,

zulip,

grafana-on-call,

getstream,

rocket-chat,

whatsapp-business,

fcm,

apns,

expo,

one-signal,

pushpad,

push-webhook,

pusher-beams

data.channels.integrationIdentifier

string

The integration identifier

data.email

string | null

The email address of the subscriber.

data.firstName

string

The first name of the subscriber.

data.isOnline

boolean

Indicates whether the subscriber is currently online.

data.lastName

string

The last name of the subscriber.

data.lastOnlineAt

string

The timestamp indicating when the subscriber was last online, in ISO 8601 format.

data.locale

string

The locale setting of the subscriber, indicating their preferred language or region.

data.phone

string

The phone number of the subscriber.

data.topics

string[]

An array of topics that the subscriber is subscribed to.