Notifications Platform APIs
Sendbird's Notifications API allows you to directly interact with data resources associated with notification activities in your Sendbird application. The Notifications API is designed to use standard HTTP protocols and return
JSON payloads in response to HTTP requests. It's internally implemented based on the
RESTful principles. While Sendbird Chat UIKit for Notifications handles many of the requests and responses at the client side, the API allows for more flexibility and adds more functionalities to your service from the server side.
Sendbird Notifications currently supports only one API endpoint to send a notification. After creating and designing a template in Sendbird Dashboard, you can send the notification to up to 10,000 users.
Note: The Notifications API is not designed for client-side use. Use Sendbird Chat UIKit for Notifications instead.
The base URL used for the Notifications API is formatted as shown below:
To get your Sendbird application ID, sign in to your dashboard, select the application, go to the Settings > Application > General, and then check the Application ID.
A typical HTTP request to the Notification API includes the following headers:
- Content-Type: every request must include a
- Api-Token: The Notifications API token is required for the Sendbird server to authenticate your API requests.
Your API requests must be authenticated by the Sendbird server using the API token of your Sendbird application. For this, you can use the Notifications API token in your dashboard under Settings > Notifications > Authentication, which is generated when an application has been created. The Notifications API token can be revoked or changed only by Sendbird upon request.
Note: Do not send any Notifications API requests from your app. If your API token information is leaked in the process of exchanging data, you could lose all your data by malicious API calls.
API endpoints are relative to the base URL allocated to your application. In this page, the
/notifications endpoint refers to
Note: To get your application ID, sign in to your dashboard, go to the Settings > Application > General, and then check the Application ID.
- It's recommended that the parameter values in API URLs be URL encoded, such as
List of actions
This section contains the list of error codes and responses for Notification's Platform API calls.
Error response: a
JSONformat which is used for the Sendbird server to send an error response to a client's request.
Error codes: HTTP status of each error with the corresponding error detail. Error codes in the 4xx range indicate a client-side error while codes in the 5xx range indicate a Sendbird server-side error.
All errors return a 200, 400, or 500 HTTP response. The details of each error are included in the
List of error properties
Indicates an error has occurred.
Indicates a 200, 400, or 500 HTTP response of an error.
The description of an error.
The following table lists client or server-side errors that the Notifications API returns in response to calls. For more information, see Error codes for Platform API for Sendbird Chat.
|HTTP status code