# Campaign Monitor authentication

> Depending on the authentication type you select, you need one of the following credentials:

## Prerequisites

Depending on the authentication type you select, you need one of the following credentials:

* OAuth 2.0 Authorization code: email and password.
* Bring your own OAuth 2.0 App: Client ID, Client secret.
* Basic authentication: API key.

If you want to create your own private OAuth 2.0 application, follow the steps described in the [Campaign Monitor documentation](https://www.campaignmonitor.com/api/v3-3/getting-started/#authenticating-with-oauth).

:::note
When registering your OAuth application in Campaign Monitor, make sure to set the [callback URL](connections#callback-url) to the value displayed on the connection creation page, for example `https://cloud.uipath.com/provisioning_/callback` for Automation Cloud.
:::

## Add the Campaign Monitor connection

To create a connection to your Campaign Monitor instance, you need to perform the following steps:

1. Select Orchestrator from the product launcher.
2. Select a folder, and then navigate to the **Connections** tab.
3. Select **Add connection**.
4. To open the connection creation page, select the connector from the list. You can use the search bar to find the connector.
5. Enter the required credentials for your preferred authentication and select **Connect**.

   For any secret-type field, you can select the menu next to the field and choose **Use credential asset** to reference an Orchestrator credential asset linked to an external vault instead of entering the value directly. For more information, see [Use credential assets for connections](credential-store-connections.md).

For more information about logging in to Campaign Monitor, visit the [Campaign Monitor Help Center](https://help.campaignmonitor.com/issues-logging-in).

## Scopes and permissions

You can use this connection to enable the [Campaign Monitor activities package](https://docs.uipath.com/activities/other/latest/integration-service/uipath-campaignmonitor-campaignmonitor-activities) in UiPath Studio to build automations for subscriber and list management, as well as email campaigns. The various permission-based
use cases that can be achieved are as follows:

| **Scope/Permission**  | **Use case** | **Activity/Event** |
| --- | --- | --- |
| `ViewReports` | To retrieve the campaign reports in order to ascertain its performance. | Get Campaign Summary |
| `ManageLists` | To create or manage customized lists for a selected group of subscribers in order to subsequently customize campaigns. | Create List  Replace List |
| `CreateCampaigns` | To create a campaign for a customized list of subscribers and add customized HTML content to it. | Create Campaign |
| `ImportSubscribers` | Bulk import a set of subscribers into the Campaign Monitor system. | Insert Record → Subscribers Import |
| `SendCampaigns` | To send the created campaign to all the subscribers in the associated list.  To test the campaign by sending it to a few email addresses before sending the actual campaign. | Send Campaign  Send Preview Campaign |
| `ViewSubscribersInReports` | To retrieve the history of a subscriber in order to understand his/her behavior and plan customized campaigns later. | Get Subscriber History |
| `ManageTemplates` | To retrieve the list of templates from the account. | List All Records → Clients Templates |
| `AdministerPersons` | To add or update a subscriber in a list based on any new info or inputs. | Add Subscriber  Update Subscriber Details |
| `AdministerAccount` | To create and retrieve clients so as to categorize the lists/subscribers org/account wise. | Create Client  List All Clients |
| `ViewTransactional` | To gain permission to view transactional reports and message logs. | N/A |
| `SendTransactional` | To gain permission to send transactional emails. | N/A |