Request Syntax Request Parameters Response Syntax Response Elements Errors See Also

CreatePartner

Creates a new partner account in the AWS Partner Network with the specified details and configuration.

Request Syntax


{
   "AllianceLeadContact": { 
      "BusinessTitle": "string",
      "Email": "string",
      "FirstName": "string",
      "LastName": "string"
   },
   "Catalog": "string",
   "ClientToken": "string",
   "EmailVerificationCode": "string",
   "LegalName": "string",
   "PrimarySolutionType": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.

Note

In the following list, the required parameters are described first.

AllianceLeadContact

The primary contact person for alliance and partnership matters.

Type: AllianceLeadContact object

Required: Yes

Catalog

The catalog identifier where the partner account will be created.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 64.

Pattern: [a-zA-Z0-9-]+

Required: Yes

EmailVerificationCode

The verification code sent to the alliance lead contact's email to confirm account creation.

Type: String

Length Constraints: Fixed length of 6.

Pattern: [0-9]+

Required: Yes

LegalName

The legal name of the organization becoming a partner.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 80.

Pattern: [\u0020-\u007E\u00A0-\uD7FF\uE000-\uFFFD]+

Required: Yes

PrimarySolutionType

The primary type of solution or service the partner provides (e.g., consulting, software, managed services).

Type: String

Required: Yes

ClientToken

A unique, case-sensitive identifier that you provide to ensure the idempotency of the request.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 64.

Pattern: [A-Za-z0-9-_]+

Required: No

Tags

A list of tags to associate with the partner account for organization and billing purposes.

Type: Array of Tag objects

Array Members: Minimum number of 0 items. Maximum number of 200 items.

Required: No

Response Syntax


{
   "AllianceLeadContact": { 
      "BusinessTitle": "string",
      "Email": "string",
      "FirstName": "string",
      "LastName": "string"
   },
   "Arn": "string",
   "AwsTrainingCertificationEmailDomains": [ 
      { 
         "DomainName": "string",
         "RegisteredAt": "string"
      }
   ],
   "Catalog": "string",
   "CreatedAt": "string",
   "Id": "string",
   "LegalName": "string",
   "Profile": { 
      "Description": "string",
      "DisplayName": "string",
      "IndustrySegments": [ "string" ],
      "LocalizedContents": [ 
         { 
            "Description": "string",
            "DisplayName": "string",
            "Locale": "string",
            "LogoUrl": "string",
            "WebsiteUrl": "string"
         }
      ],
      "LogoUrl": "string",
      "PrimarySolutionType": "string",
      "ProfileId": "string",
      "TranslationSourceLocale": "string",
      "WebsiteUrl": "string"
   }
}

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

AllianceLeadContact

The alliance lead contact information for the partner account.

Type: AllianceLeadContact object

Arn

The Amazon Resource Name (ARN) of the created partner account.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 200.

Pattern: arn:[a-z-]+:partnercentral:[a-z0-9-]+:[0-9]{12}:catalog/[A-Za-z-_]+/partner/partner-[A-Za-z0-9]{13}

Catalog

The catalog identifier where the partner account was created.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 64.

Pattern: [a-zA-Z0-9-]+

CreatedAt

The timestamp when the partner account was created.

Type: Timestamp

Id

The unique identifier of the created partner account.

Type: String

Pattern: partner-[A-Za-z0-9]{13}

LegalName

The legal name of the partner organization.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 80.

Pattern: [\u0020-\u007E\u00A0-\uD7FF\uE000-\uFFFD]+

Profile

The partner profile information including display name, description, and other public details.

Type: PartnerProfile object

AwsTrainingCertificationEmailDomains

The list of verified email domains associated with AWS training and certification credentials for the partner organization.

Type: Array of PartnerDomain objects

Array Members: Minimum number of 0 items. Maximum number of 100 items.

Errors

For information about the errors that are common to all actions, see Common Errors.

AccessDeniedException

The request was denied due to insufficient permissions. The caller does not have the required permissions to perform this operation.

Reason: The specific reason for the access denial.

HTTP Status Code: 400

ConflictException

The request could not be completed due to a conflict with the current state of the resource. This typically occurs when trying to create a resource that already exists or modify a resource that has been changed by another process.

Reason: The specific reason for the conflict.

HTTP Status Code: 400

InternalServerException

An internal server error occurred while processing the request. This is typically a temporary condition and the request may be retried.

HTTP Status Code: 500

ThrottlingException

The request was throttled due to too many requests being sent in a short period of time. The client should implement exponential backoff and retry the request.

QuotaCode: The quota code associated with the throttling error.
ServiceCode: The service code associated with the throttling error.

HTTP Status Code: 400

ValidationException

The request failed validation. One or more input parameters are invalid, missing, or do not meet the required format or constraints.

ErrorDetails: A list of detailed validation errors that occurred during request processing.
Reason: The reason for the validation failure.

HTTP Status Code: 400