Overview

SDK used by client applications to interface with the Courier API.  

Requirements
Courier Account	Sign Up
Client API Key	Get key

 

Supported Interfaces

Feature	Description
Identify	Event that triggers a user Create or Update within Courier Profiles.
Track	Event ingested by Courier can be used to trigger an automation or supply inline payloads within an existing automation workflow.
GeneratePreferencesUrl	Generates URL that can be used to link users to Preferences Center to manage their notification preferences.

Installation

1# npm
2npm install @trycourier/courier-js
3# yarn
4yarn add @trycourier/courier-js
5# pnpm
6pnpm add @trycourier/courier-js

 

Usage

Initializing Client

1import courier from "@trycourier/courier-js";
2
3courier.init({
4  clientKey: "<REPLACE_WITH_YOUR_CLIENT_KEY>",
5  debug: true, // debug enables client side logs for error catching
6});

Identify

1await courierSDK.identify("purbleUserId", {
2      email: "customer@purbleplace.com",
3      favoriteColor: "purple",
4});

Track

Basic

1await courierSDK.track("user-signup");

With data payload

1await courierSDK.track("bake-cake", { 
2    cakeFlavor: "carrot", 
3    frosting: "cream cheese"
4});

GeneratePreferencesUrl

1const prefCenterLink = courier.generatePreferencesUrl("<user-id>", {
2  // optional
3  brandId: "<brand-id>",
4});

Share feedback with Courier

We are building the best SDKs for handling notifications! Have an idea or feedback about our SDKs? Here are some links to contact us:

• Courier Feedback
• Courier JS Issues