# Get started with the Ads Unified Platform public API

> Set up an organization, service account, and API key to start managing your apps, placements, or campaigns programmatically with the Ads Unified Platform public API.

The Ads Unified Platform public API is the latest version of the Manage API (legacy) for the Unity Monetization and Unity User Acquisition dashboards.

If you already use the Manage API (legacy) in the Unity Monetization or User Acquisition dashboards, refer to [Migrate to the New Unity Dashboard using the Ads Unified Platform public API](/monetization/performance-and-analytics/api/manage-api/migrate-to-the-new-dashboard-manage-api.md) instead.

While you can manage your apps, placements, and campaigns directly in the Unity dashboards, the Ads Unified Platform public API enables you to manage your endpoints programmatically instead. The following table details the endpoints you can manage with the API:

| **Dashboard**    | **Managed endpoints**                                                               | **Benefits**                                                                                                                                                                                   |
| ---------------- | ----------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Monetization     | * Apps
* Placements
* Test devices                                                  | Create and update placements in bulk instead of one at a time.These endpoints are useful if you regularly launch new apps, add placements, or adjust test devices across different ad formats. |
| User Acquisition | - Apps
- Attribution
- Campaigns
- Campaign management
- Creative packs
- Creatives | Automate changes instead of making them one at a time in the dashboard.These endpoints are useful if you manage a large number of campaigns or need to make frequent updates.                  |

To get started with the Ads Unified Platform public API, complete the following setup tasks:

1. [Prerequisites](#prerequisites)
2. [Create an organization](#create-an-organization)
3. [Create a service account](#create-a-service-account)
4. [Generate your API key](#generate-your-api-key)
5. [Implement the Ads Unified Platform public API](#implement-the-ads-unified-platform-public-api)

1) **Prerequisites**

   Before you get started with the Ads Unified Platform public API, ensure someone on your team has the following Organization roles in the Unity dashboards:

   | **Dashboard**    | **Required role** |
   | ---------------- | ----------------- |
   | Monetization     | Owner             |
   | User Acquisition | Manager           |

2) **Create an organization**

   Create an organization to manage your endpoints in the Ads Unified Platform public API.

   Refer to [Create an organization](/cloud/organizations/create-organization.md) to set one up,  and other [Organizations](/cloud/organizations.md) articles to manage or update your organization after you create it.

3) **Create a service account**

   Create a service account from the [New Unity Dashboard](https://cloud.unity.com/) to authenticate your API calls.

   ### Advertisers

   To create a service account from the User Acquisition dashboard and add advertiser-specific roles to it, complete the following steps:

   1. Go to the User Acquisition dashboard > **Settings** > **Organization** > **Manage organization** > **Service accounts** > **+ New**.
   2. Select **+ manage organization roles**.
   3. Enter a service account name and service account description.
   4. From the new service account page you created, go to the **Organization roles** section > **+ Manage organization roles**.
   5. From the organization roles dialog, go to the **Grow** dropdown, then select all the Advertise API roles in the list to add to your service account.

   ### Publishers

   To create a service account from the Monetization dashboard and add publisher-specific roles to it, complete the following steps:

   1. Go to the Monetization dashboard > **Settings** > **Organization** > **Manage organization** > **Service accounts** > **+ New**.
   2. Select **+ manage organization roles**.
   3. Enter a service account name and service account description.
   4. From the new service account page you created, go to the **Organization roles section** > **+ Manage organization roles**.
   5. From the organization roles dialog, go to the **Monetization** dropdown, then select the following Publisher API roles to add to your service account:

   * **Ads Publisher Automation**
   * **Ads Publisher Test Devices Automation**

4) **Generate your API key**

   To create an API key to authenticate your requests from the Unity Dashboard, do the following from your new service account:

   1. Go to the **Keys** section of your service account.
   2. Select **+ Add key** to create your API key.

   > **Important:**
   >
   > The dashboard displays secret keys only once, so store the Key ID and Secret securely together for your reference later. If you lose the key values, you must create a new key.

   3. Select **Done**.

5) **Implement the Ads Unified Platform public API**

   Refer to the following API reference to build your integration.

   * Publishers: [Ads Unified Platform Publisher Public API](/oas-unified-platform-publisher-public/1.0.0.md)
   * Advertisers: [Ads Unified Platform Advertiser Public API](/oas-unified-platform-advertiser-public/1.0.0.md)