Notifications Platform API v1
Notifications
Version 1

Overview

Copy link

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 only supports 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.


Base URL

Copy link

The base URL used for the Notifications API is formatted as shown below:

https://api-{application_id}.notifications.sendbird.com/v1

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.


Headers

Copy link

A typical HTTP request to the Notification API includes the following headers:

Content-Type: application/json; charset=utf8
Api-Token: {notifications_api_token}
  • Content-Type: every request must include a Content-Type header.
  • Api-Token: The Notifications API token is required for the Sendbird server to authenticate your API requests.

Authentication

Copy link

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.

"Api-Token": {notifications_api_token}

Note: Don't 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.


Actions

Copy link

API endpoints are relative to the base URL allocated to your application. In this page, the /notifications endpoint refers to https://api-{application_id}.notifications.sendbird.com/v1.

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 {template.key}.

List of actions

Copy link
ActionHTTP request

Send a notification in real-time

POST /notifications
Sends a notification in real-time to a specific notification channel.

Send a batch of notifications

POST /notifications
Sends a batch of notifications to up to 10,000 users.

Send a batch of notifications using a CSV file

POST /notifications
Sends a batch of notifications to up to 100,000 users.

List target files

GET /storage/target_files
Retrieves all uploaded target files.


Resource representation

Copy link

The following table shows the list of properties in a files resource.

Property nameTypeDescription

file_key

string

Specifies the unique identifier of the file.

file_size

number

Specifies the size of the target file.

expires_at

long

The time at which the target file expires in Unix milliseconds format from the time of file uploading is complete. (Default: 30 days)

uploaded_at

long

The time at which the target file was uploaded through the pre-signed URL in Unix milliseconds format.