Update subscriber credentials

PUT

subscribers

{subscriberId}

credentials

curl --request PUT \
  --url https://api.novu.co/v1/subscribers/{subscriberId}/credentials \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "providerId": "slack",
  "integrationIdentifier": "<string>",
  "credentials": {
    "webhookUrl": "<string>",
    "channel": "<string>",
    "deviceTokens": [
      "<string>"
    ],
    "alertUid": "<string>",
    "title": "<string>",
    "imageUrl": "<string>",
    "state": "<string>",
    "externalUrl": "<string>"
  }
}'

{
  "data": {
    "_id": "<string>",
    "firstName": "<string>",
    "lastName": "<string>",
    "email": "<string>",
    "phone": "<string>",
    "avatar": "<string>",
    "locale": "<string>",
    "subscriberId": "<string>",
    "channels": [
      {
        "providerId": "slack",
        "integrationIdentifier": "<string>",
        "credentials": {
          "webhookUrl": "<string>",
          "channel": "<string>",
          "deviceTokens": [
            "<string>"
          ],
          "alertUid": "<string>",
          "title": "<string>",
          "imageUrl": "<string>",
          "state": "<string>",
          "externalUrl": "<string>"
        },
        "_integrationId": "<string>"
      }
    ],
    "topics": [
      "<string>"
    ],
    "isOnline": true,
    "lastOnlineAt": "<string>",
    "_organizationId": "<string>",
    "_environmentId": "<string>",
    "deleted": true,
    "createdAt": "<string>",
    "updatedAt": "<string>",
    "__v": 123
  }
}

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

E.g ApiKey 18d2e625f05d80e

Authorizations

Authorization

string

headerrequired

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

Path Parameters

subscriberId

string

required

Body

application/json

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

integrationIdentifier

string

The integration identifier

credentials

object

required

Credentials payload for the specified provider

Response

200 - application/json

data

object

data._id

string

The internal id novu generated for your subscriber, this is not the subscriberId matching your query. See subscriberId for that

data.firstName

string

data.lastName

string

data.email

string

data.phone

string

data.avatar

string

data.locale

string

data.subscriberId

string

required

The internal identifier you used to create this subscriber, usually correlates to the id the user in your systems

data.channels

object[]

Channels settings for subscriber

data.topics

string[]

Topics that subscriber belongs to

data.isOnline

boolean

data.lastOnlineAt

string

data._organizationId

string

required

data._environmentId

string

required

data.deleted

boolean

required

data.createdAt

string

required

data.updatedAt

string

required

data.__v

number

Was this page helpful?

Delete subscriber Delete subscriber credentials by providerId

curl --request PUT \
  --url https://api.novu.co/v1/subscribers/{subscriberId}/credentials \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "providerId": "slack",
  "integrationIdentifier": "<string>",
  "credentials": {
    "webhookUrl": "<string>",
    "channel": "<string>",
    "deviceTokens": [
      "<string>"
    ],
    "alertUid": "<string>",
    "title": "<string>",
    "imageUrl": "<string>",
    "state": "<string>",
    "externalUrl": "<string>"
  }
}'

{
  "data": {
    "_id": "<string>",
    "firstName": "<string>",
    "lastName": "<string>",
    "email": "<string>",
    "phone": "<string>",
    "avatar": "<string>",
    "locale": "<string>",
    "subscriberId": "<string>",
    "channels": [
      {
        "providerId": "slack",
        "integrationIdentifier": "<string>",
        "credentials": {
          "webhookUrl": "<string>",
          "channel": "<string>",
          "deviceTokens": [
            "<string>"
          ],
          "alertUid": "<string>",
          "title": "<string>",
          "imageUrl": "<string>",
          "state": "<string>",
          "externalUrl": "<string>"
        },
        "_integrationId": "<string>"
      }
    ],
    "topics": [
      "<string>"
    ],
    "isOnline": true,
    "lastOnlineAt": "<string>",
    "_organizationId": "<string>",
    "_environmentId": "<string>",
    "deleted": true,
    "createdAt": "<string>",
    "updatedAt": "<string>",
    "__v": 123
  }
}