Add the current user as a subscriber of Cloud Message (CM). This will allow the user to receive push notifications on the device. Note: Include subscriptionId or deviceId in the request body.

For information on how to receive Cloud Messages sent to your client application, see here

URL Parameters

None.

Body Parameters

NameDescriptionJSON typeRequiredDefault Value
dataOnlyData only messages are not processed as push notifications by device, client app must process message data.booleanNofalse
subscriptionTypeCurrently only 'firebase' supported.stringNofirebase
subscriptionIdUnique identifier of the subscription.stringOnly if no deviceId
deviceIdUnique identifier of the device.stringOnly if no subscriptionId
scopeCategory of notifications to subscribe ('group', 'direct', 'all').arrayNoall
deviceTypeType of device ('browser', 'mobile').stringNo

Authentication

JwtAuthenticator, Oauth2Authenticator, AnonymousAuthenticator

Authorization

OAuthAuthorizer

Example Request

URL

POST https://spaces/zang.io/api/users/me/cm/subscriptions

Headers

Authorization: "jwt eyJhbGciOiJSUzI1NiIsIdfgdfgnR5cCI6IkpXVCJ9.eyJ1c2VyX2lkX3NpZyI6ImxPWHpxNzVzR3J3X0xwWEMyRGRMakhyYXJlWVhyTzFMdEZHZkhkOWNkTXciLCJwcm9kdWN0X3R5cGUiOiJhY2NvdW50cyIsImxhc3R1cGRhdGV0aW1lIjoiMjAxNy0wMS0zMFQxMzo1ODo0Ny4yMDYiLCJpc3MiOiJ6YW5nLmlvIiwicHVibGlja2V5aWQiOiJhZ3h6Zm05dVpYTnVZVEl3TVRSeUdnc1NEVWRLZDNSUWRXSnNhV05MWlhrdfgdWdJQ2dsUEtFakFvTSIsImV4cCI6MTQ5NTM5MTIwMywidXNlcl9pZCI6ImFneHpmbTl1WlhOdVlUSXdNVFJ5RVFzU0JGVnpaWElZZ0lEQXMtX25fUW9NIiwidmVyIjoiMi4wIn0.SqZpw1uPIebqW3qlDsm0-DWYFKEH0SgPwtD-tSESWOF-5hLkZMqJH28ooWux2S7s9riIew7pTVPnZpTgJa5zHcEAG0gXSEJVOqmpGp_4ufM8YtZoZMpBFjyAkwyAt-ILkGUYIo0GU5WyzMPLV8YLXfgdfgOgkE2MGGOajBkjPmC2Db3pA0D0M9k-21EL1gwWBC5YIq0PDAkgulegwl6khRmB8irJQ-dfg-d-KV9eYfFpsCdJKRGzSfqg"

Or

Authorization: "bearer f746696f5de4528u128ae2f274eea253e8a7943a"

Example Request Body

{
  "subscriptionId": "12344444444",
  "scope": ["all"]
}

Example Response

{
  "_id": "59021e333bab0e18ff0509aa",
  "subscriptionId": "12344444444",
  "__v": 0,
  "userId": "5890b1243bab0e18ff044943",
  "userType": "user",
  "uid": "user_5890b1243bab0e18ff044943",
  "expires": "2018-04-27T16:54:29.626Z",
  "type": "firebase",
  "dataOnly": false,
  "deviceId": "d2f9e527-c119-4ee5-c275-d5146f43240b",
  "created": "2017-04-27T16:51:40.869Z",
  "id": "59021e333bab0e18ff0509aa"
}