Method: accounts.channelPartnerLinks.create

Stay organized with collections Save and categorize content based on your preferences.

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 inviteLinkUri 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.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Required. Create a channel partner link for the provided reseller account's resource name. Parent uses the format: accounts/{account_id}

Query parameters



Optional. The invited partner's domain. Either domain or channelPartnerLink.reseller_cloud_identity_id can be used to create a link. Deprecated: Use ChannelPartnerLink.reseller_cloud_identity_id instead

Request body

The request body contains an instance of ChannelPartnerLink.

Response body

If successful, the response body contains a newly created instance of ChannelPartnerLink.

Authorization Scopes

Requires the following OAuth scope:


For more information, see the Authentication Overview.