---
title: "POST /v23/customers/{+customerId}/accountLinks:create"
method: POST
path: "/v23/customers/{+customerId}/accountLinks:create"
tags: ["customers"]
---

# POST /v23/customers/{+customerId}/accountLinks:create

`POST /v23/customers/{+customerId}/accountLinks:create`

## Request

- Base URL: `https://searchads360.googleapis.com`
- URL: `https://searchads360.googleapis.com/v23/customers/{+customerId}/accountLinks:create`
- Auth: OAuth 2 (implicit, authorization URL `https://accounts.google.com/o/oauth2/auth`, scopes: `https://www.googleapis.com/auth/doubleclicksearch`) and OAuth 2 (authorization code, authorization URL `https://accounts.google.com/o/oauth2/auth`, token URL `https://accounts.google.com/o/oauth2/token`, scopes: `https://www.googleapis.com/auth/doubleclicksearch`)

Creates an account link. List of thrown errors: [AuthenticationError]() [AuthorizationError]() [DatabaseError]() [FieldError]() [HeaderError]() [InternalError]() [MutateError]() [QuotaError]() [RequestError]() [ThirdPartyAppAnalyticsLinkError]()

## Path parameters

- `customerId` string, required

## Request body

- GoogleAdsSearchads360V23ServicesCreateAccountLinkRequest: Request message for AccountLinkService.CreateAccountLink.
  - `accountLink` GoogleAdsSearchads360V23ResourcesAccountLink: Represents the data sharing connection between a Google Ads account and another account
    - `accountLinkId` string, int64: Output only. The ID of the link. This field is read only.
    - `resourceName` string: Immutable. Resource name of the account link. AccountLink resource names have the form: `customers/{customer_id}/accountLinks/{account_link_id}`
    - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'REMOVED' | 'REQUESTED' | 'PENDING_APPROVAL' | 'REJECTED' | 'REVOKED': The status of the link.
    - `thirdPartyAppAnalytics` GoogleAdsSearchads360V23ResourcesThirdPartyAppAnalyticsLinkIdentifier: The identifiers of a Third Party App Analytics Link.
      - `appAnalyticsProviderId` string, int64: Immutable. The ID of the app analytics provider. This field should not be empty when creating a new third party app analytics link. It is unable to be modified after the creation of the link.
      - `appId` string: Immutable. A string that uniquely identifies a mobile application from which the data was collected to the Google Ads API. For iOS, the ID string is the 9 digit string that appears at the end of an App Store URL (for example, "422689480" for "Gmail" whose App Store link is https://apps.apple.com/us/app/gmail-email-by-google/id422689480). For Android, the ID string is the application's package name (for example, "com.google.android.gm" for "Gmail" given Google Play link https://play.google.com/store/apps/details?id=com.google.android.gm) This field should not be empty when creating a new third party app analytics link. It is unable to be modified after the creation of the link.
      - `appVendor` 'UNSPECIFIED' | 'UNKNOWN' | 'APPLE_APP_STORE' | 'GOOGLE_APP_STORE': Immutable. The vendor of the app. This field should not be empty when creating a new third party app analytics link. It is unable to be modified after the creation of the link.
    - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'THIRD_PARTY_APP_ANALYTICS': Output only. The type of the linked account.

## Response `200`

Successful response

## Changes

- **2026-10-10** `3c8ec4f526ec`: 2 breaking
  - removed the request body
  - removed the media type `*/*` for the response with the status `200`

[Operation history](https://skmtc.dev/google/apis/searchads360/changes/v23/customers/:customerId/accountLinks:create/post.md)

---

[API](https://skmtc.dev/google/apis/searchads360.md) · [All operations](https://skmtc.dev/google/apis/searchads360/llms.txt) · [OpenAPI document](https://skmtc.dev/google/apis/searchads360/revisions/3c8ec4f526ec?raw)