tencent cloud

International Partners

Release Notes
Introduction to Channel Partners
Partner Type and Level
Partner Platform Function Overview
User Guide (Reseller)
Become a Partner
Sign in to Partner Center
Account and Organization Information Management
Customer Management
Reseller Management
Managing Reseller
Expense Management
Commission Management
Agreement Management
User Guide (Customer)
Invited to Bind as a Customer
Unbind Reseller
Account Management
Product Purchase
Renewal Management
Bill Management
Cost Management
Agreement Management
User Guide (Partner Academy)
Partner Academy Guide
Becoming an MSP
Becoming a CSP
Agreement Management
Security and Compliance
Access Management
API Documentation
History
Introduction
API Category
Making API Requests
Customer Management APIs
Credit Management APIs
Agent APIs
Bill Management APIs
Voucher Management APIs
Commission Management APIs
Data Types
Error Codes
FAQs
Partner Onboarding
End Customer Relationship Management
Credit Management
Vouchers
Purchase Transactions
Discount Management
About Bills
Organization Management
Contact Us
Glossary
DocumentationInternational PartnersAPI DocumentationCustomer Management APIsCreateAccount

CreateAccount

PDF
Focus Mode
Font Size
Last updated: 2026-02-10 10:38:56

1. API Description

Domain name for API request: intlpartnersmgt.intl.tencentcloudapi.com.

This API is used to create Tencent Cloud customer accounts for distributor/second-level resellers.After the account is created, it will be automatically bound to the partner account.Note:

  1. Create a Tencent Cloud account. The entered email address and mobile phone number need to be verified by the partner for validity.
  2. Customers need to add personal information when logging in for the first time.
  3. This interface needs to be applied for allowlist usage. Please contact the channel manager to initiate the application process.

Callable roles: Distributor, Second-level reseller, Reseller

A maximum of 5 requests can be initiated per second for this API.

We recommend you to use API Explorer
Try it
API Explorer provides a range of capabilities, including online call, signature authentication, SDK code generation, and API quick search. It enables you to view the request, response, and auto-generated examples.

2. Input Parameters

The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.

Parameter Name Required Type Description
Action Yes String Common Params. The value used for this API: CreateAccount.
Version Yes String Common Params. The value used for this API: 2022-09-28.
Region No String Common Params. This parameter is not required.
AccountType Yes String Account type of a new customer.
Valid values: personal, company.
Mail Yes String Registered email address, which should be valid and correct.
such as "account@qq.com"
Password Yes String Account password.
Length limit: 8-20 characters
A password must contain numbers, letters, and symbols (!@#$%^&*()). Space is not allowed.
ConfirmPassword Yes String The confirmed password, which must be the same as that entered in the Password field.
PhoneNum Yes String Customer's mobile number.
The caller needs to ensure the validity and correctness of the mobile number. A global mobile number within a range of 1-32 digits is allowed.
The system will perform binding limit verification of the mobile number you provide, allowing a maximum of 5 accounts per mobile number.
CountryCode Yes String Customer's country/region code, which can be obtained via the GetCountryCodes API, such as "852".
Parameter value is not allowed to be 7,380,86.
Area Yes String Customer's ISO2 standard country/region code, which can be obtained via the GetCountryCodes API. It should correspond to the CountryCode field, such as HK.
VerifyCode Yes String VerifyCode. This parameter is required.
Use the SendVerifyCode API to obtain the verifycode.The SendVerifyCode API sends a 6-digit verifycode to your specified mobile number via SMS. After receiving it, you need to pass it along with other parameters.
TradeOne Yes String Layer-1 industry id. This is a required item and can be obtained via the GetTradeConfigList API,
such as "kghy_01".
TradeTwo Yes String Layer-2 industry id. This is a required item and can be obtained via the GetTradeConfigList API,
such as "kghy_0101"
Extended No String Extension field, which is left empty by default.
CustomerName No String For individual customers, fill in the name. for corporate customers, fill in the full company name.Constraints:
1. Length: 2~200 characters
2. Customer name cannot be pure numbers

3. Output Parameters

Parameter Name Type Description
Uin String Account UIN
Reason String Binding Results
RequestId String The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.

4. Example

Example1 Applying to Create a Customer Account

apply to create a customer account

Input Example

POST / HTTP/1.1
Host: intlpartnersmgt.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateAccount
<Common request parameters>

{
    "Extended": "for personal",
    "CountryCode": "852",
    "Area": "HK",
    "PhoneNum": "18888888888",
    "AccountType": "business",
    "Mail": "account@qq.com",
    "Password": "ABCabc123!",
    "ConfirmPassword": "ABCabc123",
    "VerifyCode": "364928",
    "TradeOne": "kghy_01",
    "TradeTwo": "kghy_0101"
}

Output Example

{
    "Response": {
        "Uin": "200000123456",
        "RequestId": "a9e390a7-a1af-42cd-8178-13bd046337a7"
    }
}

5. Developer Resources

SDK

TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.

Command Line Interface

6. Error Code

The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.

Error Code Description
AuthFailure CAM signature/authentication error.
FailedOperation.ExceedMaxBindCount The maximum number of bindable sub-accounts has been exceeded.
FailedOperation.MailIsRegistered FailedOperation.MailIsRegistered
FailedOperation.PhoneBindUpper The number of registered accounts for the current mobile number has reached the maximum limit. Please change the phone number and try again.
FailedOperation.TradeInfoIncorrect The primary industry id and secondary industry id do not match.
FailedOperation.VerificationCodeIllegal Incorrect verification code.
InternalError Internal error.
InvalidParameter.AccountTypeContentIncorrect InvalidParameter.AccountTypeContentIncorrect
InvalidParameter.AreaContentIncorrect InvalidParameter.AreaContentIncorrect
InvalidParameter.AreaFormatIncorrect InvalidParameter.AreaFormatIncorrect
InvalidParameter.ConfirmPasswordContentIncorrect InvalidParameter.ConfirmPasswordContentIncorrect
InvalidParameter.CountryCodeContentIncorrect InvalidParameter.CountryCodeContentIncorrect
InvalidParameter.CountryCodeFormatIncorrect InvalidParameter.CountryCodeFormatIncorrect
InvalidParameter.MailFormatIncorrect InvalidParameter.MailFormatIncorrect
InvalidParameter.PasswordContentIncorrect InvalidParameter.PasswordContentIncorrect
InvalidParameter.PasswordFormatIncorrect InvalidParameter.PasswordFormatIncorrect
InvalidParameter.PhoneNumFormatIncorrect InvalidParameter.PhoneNumFormatIncorrect
InvalidParameterValue.AccountTypeEmpty InvalidParameterValue.AccountTypeEmpty
InvalidParameterValue.AreaEmpty InvalidParameterValue.AreaEmpty
InvalidParameterValue.CountryCodeEmpty InvalidParameterValue.CountryCodeEmpty
InvalidParameterValue.MailEmpty InvalidParameterValue.MailEmpty
InvalidParameterValue.PasswordEmpty InvalidParameterValue.PasswordEmpty
InvalidParameterValue.PhoneNumEmpty InvalidParameterValue.PhoneNumEmpty
InvalidParameterValue.TradeInfoEmpty The primary industry id or secondary industry id is empty.
InvalidParameterValue.UnSupportArea The current region does not support creating a Tencent Cloud International account.
UnauthorizedOperation Unauthorized operation.
Previous Topic: QueryVoucherPoolNext Topic: DescribeCustomerInfo

Help and Support

Was this page helpful?

Help us improve! Rate your documentation experience in 5 mins.

Feedback