v29

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-06-042661,1122.5 MB

business_access_invite

Create a request to access an existing partner's assets.

Create a request to access an existing partner's assets with the specified permissions. The request will be sent to the partner for approval. The assets that can be requested are ad accounts and profiles.

post/businesses/{business_id}/requests/assets/access

Path parameters

business_idstring required

Unique identifier of the requesting business.

Request body

Example request

{
  "asset_requests": [
    {
      "asset_id_to_permissions": {
        "549760723247": [
          "ANALYST"
        ],
        "549760723248": [
          "ANALYST",
          "ADMIN"
        ],
        "809944451643622187": [
          "PROFILE_PUBLISHER"
        ]
      }
    }
  ]
}

Response

The request has succeeded.

invitesobject

An object mapping each partner id to the asset access request id. Only one request id is returned per partner.

Example response

{
  "invites": {
    "766456567741825556": "5349280584552211583",
    "733242520489967216": "5349280584552211845"
  }
}