tencent cloud

All product documents
APIs
DocumentationAPIsInternational PartnersCustomer Management APIsCreateAccount
CreateAccount
Last updated: 2025-02-27 10:06:49
CreateAccount
Last updated: 2025-02-27 10:06:49

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.
Extended No String Extension field, which is left empty by default.
TradeOne No String Layer-1 industry id. This is a required item and can be obtained via the GetTradeConfigList API,
such as "kghy_01".
TradeTwo No String Layer-2 industry id. This is a required item and can be obtained via the GetTradeConfigList API,
such as "kghy_0101"

3. Output Parameters

Parameter Name Type Description
Uin String Account UIN
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

Applying 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"
}

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
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.
Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback

Contact Us

Contact our sales team or business advisors to help your business.

Contact Us
Technical Support

Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

Submit a Ticket
7x24 Phone Support