---
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`

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
    - `thirdPartyAppAnalytics` GoogleAdsSearchads360V23ResourcesThirdPartyAppAnalyticsLinkIdentifier — The identifiers of a Third Party App Analytics 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.
      - `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.
      - `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.
    - `resourceName` string — Immutable. Resource name of the account link. AccountLink resource names have the form: `customers/{customer_id}/accountLinks/{account_link_id}`
    - `accountLinkId` string, int64 — Output only. The ID of the link. This field is read only.
    - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'REMOVED' | 'REQUESTED' | 'PENDING_APPROVAL' | 'REJECTED' | 'REVOKED' — The status of the link.
    - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'THIRD_PARTY_APP_ANALYTICS' — Output only. The type of the linked account.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/searchads360.md) · [All operations](https://skmtc.net/google/apis/searchads360/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/searchads360/revisions/40d087435afd/schema)