---
title: "Create AOAA request"
method: POST
path: "/businesses/{business_id}/partners/{partner_id}/ad_account_request"
tags: ["business_access_invite"]
---

# Create AOAA request

`POST /businesses/{business_id}/partners/{partner_id}/ad_account_request`

## Request

- Base URL: `https://api.pinterest.com/v5`
- URL: `https://api.pinterest.com/v5/businesses/{business_id}/partners/{partner_id}/ad_account_request`
- Auth: OAuth 2
  - Authorization code: `https://www.pinterest.com/oauth/`
  - Token URL: `https://api.pinterest.com/v5/oauth/token` scopes: `biz_access:write`

Create a request for an Agency Owned Ad Account (AOAA).

## Path parameters

- `business_id` string, required
- `partner_id` string, required

## Request body

- AgencyOwnedPartnerAdAccountRequestCreate: Resource create operation model.
  - `name` string, required: Ad account name.
  - `country` string, required: Ad account country.
  - `currency` 'UNK' | 'USD' | 'GBP' | 'CAD' | 'EUR' | 'AUD' | 'NZD' | 'SEK' | 'ILS' | 'CHF' | 'HKD' | 'JPY' | 'SGD' | 'KRW' | 'NOK' | 'DKK' | 'PLN' | 'RON' | 'HUF' | 'CZK' | 'BRL' | 'MXN' | 'ARS' | 'CLP' | 'COP' | 'INR' | 'TRY': Currency Codes from ISO 4217
  - `business_id_to_permissions` object, required: Business id to permissions mapping.

## Response `200`

The request has succeeded.

- AgencyOwnedPartnerAdAccountRequest: AOAA request create payload and response data.
  - `business_id` string, required
  - `data` object, required: Partner id to created request id mapping.

## Other responses

- `201`: Resource create operation completed successfully.
- `400`: The request could not be understood by the server due to unexpected data.
- `401`: Authentication is required and has either failed or not been provided.
- `403`: The request was valid, but the server is refusing action. The user might not have the necessary permissions for a resource.
- `404`: The requested resource could not be found on this server.
- `429`: The user has sent too many requests in a given amount of time and is being rate limited.
- `default`: An unexpected error response.

## Changes

- **2026-11-19** (v5) `cc5c1b75cc2c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/businesses/:business_id/partners/:partner_id/ad_account_request/post.md)

---

[API](https://skmtc.dev/pinterest/apis/pinterest-rest-api.md) - [All operations](https://skmtc.dev/pinterest/apis/pinterest-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pinterest/apis/pinterest-rest-api/revisions/19899fd1c8f3?raw)
