# Courier

[Courier](https://www.courier.com/) is an API and web studio for development teams to manage product-triggered notifications (email, chat, in-app, SMS, push, etc.) in one place.

{{< info >}}
This destination is maintained by [Courier](https://www.courier.com/docs/external-integrations/rudderstack). For any issues, contact the Courier [support team](mailto:support@courier.com).
{{< /info >}}

## Connection compatibility

{{< destination-config >}}

## Get started

Once you have confirmed that the source platform supports sending events to Courier, follow these steps:

1. From your [RudderStack dashboard](https://app.rudderstack.com/), add a source. Then, from the list of destinations, select **Courier**.
2. Assign a name to the destination and click **Continue**.

## Connection settings

To successfully configure Courier as a destination, you will need to configure the following settings:

- **API Key**: Enter your Courier API key. For more information on obtaining the API key, refer to the [FAQ](#faq) section.

## Identify

You can use the [`identify`]({{< ref "event-spec/standard-events/identify.md" >}}) call to sync users from RudderStack to Courier. If a user already exists in Courier, RudderStack updates the user profile with the latest values.

A sample `identify` event is shown below:

```javascript
rudderanalytics.identify('1hKOmRA4GRlm', {
  name: 'Alex Keener',
  email: 'alex@example.com',
  avatar: 'https://example.com/avatars/alexkeener.webp',
  role: 'CEO'
});
```
You can view the synced users in Courier's [Users](https://app.courier.com/users) page or access them via Courier API's.

## Track
  
You can use the [`track`]({{< ref "event-spec/standard-events/track.md" >}}) call to ingest events into Courier, which can further be mapped to [Courier Automations](https://www.courier.com/features/automations/).

A sample `track` call is shown below:

```javascript
rudderanalytics.track('Cart checkout', {
  product: 'shoe-123',
  // additional properties
})
```

The `track` events appear on Courier Studio on the [Rudderstack integration](https://app.courier.com/channels/rudderstack) page. For example, the `Cart checkout` event is mapped to `Send shipping details` automation:

{{< image src="images/event-stream-destinations/courier-rudderstack-event.webp" alt="Courier API Key" >}}

## FAQ

#### Where can I find the Courier API key?

1. Log in to your [Courier dashboard](https://app.courier.com/).
2. Go to your app's **Settings** > **API Keys**. You will find the Courier API key listed here:

{{< image src="images/event-stream-destinations/courier-api-key.webp" alt="Courier API Key" >}}

{{< info >}}
Copy the key based on the environment or scope you want to configure.
{{< /info >}}