All Products
Search

This Product

    Expenses and Costs:AddAccountRelation

    Document Center

    Expenses and Costs:AddAccountRelation

    Last Updated:Aug 28, 2026

    Creates a financial relationship.

    Operation description

    For more information about a financial relationship, see Usage notes on the trusteeship.

    If the management account and the member use the same enterprise name for real-name verification, no additional confirmation is required. Otherwise, you must call the ConfirmRelation operation to confirm the relationship.

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    No authorization for this operation. If you encounter issues with this operation, contact technical support.

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    RelationType

    string

    Yes

    The type of the financial relationship. Set the value to enterprise_group.

    enterprise_group
    ParentUserId

    integer

    Yes

    The ID of the Alibaba Cloud account used as the management account.

    1738376485192612
    ChildNick

    string

    No

    The display name of the member, used to identify the intended use of the account.

    xxx project

    ChildUserId

    integer

    Yes

    The ID of the Alibaba Cloud account used as the member.

    1512996702208737
    RequestId

    string

    Yes

    The unique ID of the request, used for tracking and troubleshooting.

    32324242444
    PermissionCodes

    array

    No

    The permissions that can be granted to the member. Valid values:

    • SYNCHRONIZE_FINANCE_IDENTITY: shares the credit control identity with the member.

    • SYNCHRONIZE_FINANCE_DISCOUNT_POLICY_TO_TARGET: shares the discount policy with the member.

    • FORBID_WITHDRAW_CASH: prevents the member from withdrawing the balance.

    • FORBID_MANAGE_INVOICE: prevents the member from managing invoices.

    • CHECK_FINANCE_INFO: requests to view financial relationship details.

    • MANAGE_TARGET_INVOICE: allows the member to manage invoices.

    • CHECK_TARGET_CONSUMPTION: allows the member to view the bills.

    PermissionCodes and RoleCodes cannot both be empty.

    CHECK_TARGET_CONSUMPTION

    string

    No

    The permission that is granted.

    SYNCHRONIZE_FINANCE_IDENTITY
    RoleCodes

    array

    No

    The roles that can be assigned to the member. Set the value to trusteeship.

    trusteeship

    string

    No

    The role assigned to the member in a trusteeship. PermissionCodes and RoleCodes cannot both be empty.

    trusteeship

    Response elements

    Element

    Type

    Description

    Example

    object

    Code

    string

    The status code returned.

    200
    Message

    string

    The message returned.

    Message returned

    RequestId

    string

    The ID of the request.

    Request ID

    Success

    boolean

    Indicates whether the request is successful.

    true
    Data

    object

    The data returned.

    HostId

    string

    The IP address of the request

    HostId
    RelationId

    integer

    The ID of the financial relationship.

    RelationId

    Examples

    Success response

    JSON format

    {
  "Code": "200",
  "Message": "Message returned\n",
  "RequestId": "Request ID\n",
  "Success": true,
  "Data": {
    "HostId": "HostId",
    "RelationId": 0
  }
}

    Error codes

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.