Help Center/ Organizations/ API Reference/ APIs/ Managing Accounts/ Creating an Account
Updated on 2026-03-05 GMT+08:00
View PDF

Creating an Account

Function

This API is used to create an account. The generated account automatically becomes a member account of the organization holding the account that calls this API. This API can be called only from the organization's management account. The Organizations service creates the required service-linked agency and account-accessed agency in the new account.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

  • If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.
  • If you are using identity policy-based authorization, the following identity policy-based permissions are required.

    Action

    Access Level

    Resource Type (*: required)

    Condition Key

    Alias

    Dependencies

    organizations:accounts:create

    Write

    -

    • g:RequestTag/<tag-key>

    • g:TagKeys

    -

    organizations:resources:tag

URI

POST /v1/organizations/accounts

Request Parameters

Table 1 Request header parameters

Parameter

Mandatory

Type

Description

X-Security-Token

No

String

Security token (session token) of your temporary security credentials. If a temporary security credential is used, this header is required.
Table 2 Request body parameters

Parameter

Mandatory

Type

Description

name

Yes

String

Account name.

email

No

String

Email address. This parameter is mandatory when an account is created at the Huawei Cloud International website.

phone

No

String

Mobile number. This parameter is mandatory when an account is created at the Huawei Cloud Chinese Mainland website.

agency_name

No

String

Agency name.

description

No

String

Description.

tags

No

Array of TagDto objects

List of tags you want to attach to the new account.
Table 3 TagDto

Parameter

Mandatory

Type

Description

key

Yes

String

Identifier or name of the tag key.

value

Yes

String

String value associated with the tag key. You can set the tag value to an empty string, but cannot set it to NULL.

Response Parameters

Status code: 202

Table 4 Response body parameters

Parameter

Type

Description

create_account_status

CreateAccountStatusDto object

States of CreateAccount requests for an organization.
Table 5 CreateAccountStatusDto

Parameter

Type

Description

account_id

String

Unique ID of the newly created account if any.

account_name

String

Account name.

completed_at

String

Date and time when the account was created and the request was completed.

created_at

String

Date and time when the CreateAccount request was made.

id

String

Unique ID of a request. You can get this value from the response to the initial CreateAccount request.

state

String

Status of the asynchronous request for creating an account.

failure_reason

String

Error 1000: Failed to query the user identity information.

Error 2000: Failed to create the account.

Error 2001: Account name conflict.

Error 3000: Failed to create the resource account.

Error 3001: This phone number has reached the maximum account registration limit.

Error 4000: Failed to create the birth token.

Error 5000: Failed to create the service-linked agency.

Error 6000: Failed to create the agency.

Error 6001: Failed to query the permission information.

Error 6002: Failed to bind the permission information.

Error 7000: Failed to associate the master account with member accounts for unified accounting.

Error 7001: Too many real-name authentication records.

Error 7002: Failed to query the financial association between the master account and member accounts.

Error 0000: System error.

failure_detail_msg

failure_detail_msg object

Detailed reason why the request fails.
Table 6 failure_detail_msg

Parameter

Type

Description

error_msg

String

Transparently Transmitting Error Codes

encoded_authorization_message

String

Transparently Transmitting Authentication Failure Information

Example Requests

Creating an account

POST https://{endpoint}/v1/organizations/accounts

{
  "name" : "C9Qzukfn6FIyxAmC3dQclrwZW34UDu_rPSRrCQ4aGFm0-r1zC2RDHt5oHA-aY21B",
  "tags" : [ {
    "key" : "keystring",
    "value" : "valuestring"
  } ]
}

Example Responses

Status code: 202

Successful

{
  "create_account_status" : {
    "account_id" : "0a6d25d23900d45c0faac010e0fb4de0",
    "account_name" : "paas_iam_573331",
    "completed_at" : "2022-08-24T06:41:15Z",
    "created_at" : "2022-08-24T06:41:15Z",
    "id" : "h-awjp43m7bz3b8jgy5v61jrfwakt3og8w",
    "state" : "in_progress",
    "failure_reason" : "string"
  }
}

Status Codes

Status Code

Description

202

Successful

Error Codes

See Error Codes.

Parent topic: Managing Accounts