---
title: "POST /v1/{+parent}/channelPartnerLinks"
method: POST
path: "/v1/{+parent}/channelPartnerLinks"
tags: ["accounts"]
---

# POST /v1/{+parent}/channelPartnerLinks

`POST /v1/{+parent}/channelPartnerLinks`

Initiates a channel partner link between a distributor and a reseller, or between resellers in an n-tier reseller channel. Invited partners need to follow the invite_link_uri provided in the response to accept. After accepting the invitation, a link is set up between the two parties. You must be a distributor to call this method. Possible error codes: * PERMISSION_DENIED: The reseller account making the request is different from the reseller account in the API request. * INVALID_ARGUMENT: Required request parameters are missing or invalid. * ALREADY_EXISTS: The ChannelPartnerLink sent in the request already exists. * NOT_FOUND: No Cloud Identity customer exists for provided domain. * INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. * UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. Return value: The new ChannelPartnerLink resource.

## Path parameters

- `parent` string, required

## Request body

- GoogleCloudChannelV1ChannelPartnerLink — Entity representing a link between distributors and their indirect resellers in an n-tier resale channel.
  - `createTime` string, google-datetime — Output only. Timestamp of when the channel partner link is created.
  - `name` string — Output only. Resource name for the channel partner link, in the format accounts/{account_id}/channelPartnerLinks/{id}.
  - `resellerCloudIdentityId` string — Required. Cloud Identity ID of the linked reseller.
  - `channelPartnerCloudIdentityInfo` GoogleCloudChannelV1CloudIdentityInfo — Cloud Identity information for the Cloud Channel Customer.
    - `alternateEmail` string — The alternate email.
    - `customerType` 'CUSTOMER_TYPE_UNSPECIFIED' | 'DOMAIN' | 'TEAM' — CustomerType indicates verification type needed for using services.
    - `languageCode` string — Language code.
    - `primaryDomain` string — Output only. The primary domain name.
    - `phoneNumber` string — Phone number associated with the Cloud Identity.
    - `isDomainVerified` boolean — Output only. Whether the domain is verified. This field is not returned for a Customer's cloud_identity_info resource. Partners can use the domains.get() method of the Workspace SDK's Directory API, or listen to the PRIMARY_DOMAIN_VERIFIED Pub/Sub event in to track domain verification of their resolve Workspace customers.
    - `adminConsoleUri` string — Output only. URI of Customer's Admin console dashboard.
    - `eduData` GoogleCloudChannelV1EduData — Required Edu Attributes
      - `website` string — Web address for the edu customer's institution.
      - `instituteSize` 'INSTITUTE_SIZE_UNSPECIFIED' | 'SIZE_1_100' | 'SIZE_101_500' | 'SIZE_501_1000' | 'SIZE_1001_2000' | 'SIZE_2001_5000' | 'SIZE_5001_10000' | 'SIZE_10001_OR_MORE' — Size of the institute.
      - `instituteType` 'INSTITUTE_TYPE_UNSPECIFIED' | 'K12' | 'UNIVERSITY' — Designated institute type of customer.
  - `inviteLinkUri` string — Output only. URI of the web page where partner accepts the link invitation.
  - `publicId` string — Output only. Public identifier that a customer must use to generate a transfer token to move to this distributor-reseller combination.
  - `updateTime` string, google-datetime — Output only. Timestamp of when the channel partner link is updated.
  - `linkState` 'CHANNEL_PARTNER_LINK_STATE_UNSPECIFIED' | 'INVITED' | 'ACTIVE' | 'REVOKED' | 'SUSPENDED' — Required. State of the channel partner link.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/cloudchannel.md) · [All operations](https://skmtc.net/google/apis/cloudchannel/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/cloudchannel/versions/7477d1d5f236/schema)