> For the complete documentation index, see [llms.txt](https://pivot-payment.gitbook.io/pivot-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pivot-payment.gitbook.io/pivot-docs/api-references/api-lists/account-and-balance/sub-account-management/assign-user-to-a-sub-account.md).

# Assign User to a Sub-account

## Method and URL

<mark style="color:green;">`POST`</mark> \[<mark style="color:orange;">BASE\_URL</mark>]/v1/sub-merchants/admin

{% hint style="info" %}
Don't forget to use <mark style="color:orange;">`x-submerchant-id`</mark> of the intended Sub-account in the Request's Header Data&#x20;
{% endhint %}

## Request

**Request Body**

```json
{
    "email": "admin@acme.inc",
    "name": "John Mayer"
}
```

**Detail Parameter Request**

<table data-full-width="false"><thead><tr><th width="224">Parameter</th><th>Data Type</th><th>Character limit</th><th width="140.671875">Requirement</th><th width="357">Description</th></tr></thead><tbody><tr><td>email</td><td>String</td><td>0-255</td><td>M</td><td>Email address of the admin user</td></tr><tr><td>name</td><td>String</td><td>1-255</td><td>M</td><td>Full name of the admin user</td></tr></tbody></table>

## Response

**Response Body**

{% code fullWidth="false" %}

```json
{
    "code": "00",
    "message": "success"
}
```

{% endcode %}

**Detail Parameter Response**

<table><thead><tr><th>Parameter</th><th width="119.73443603515625">Data Type</th><th width="137.9366455078125">Requirement</th><th>Description</th></tr></thead><tbody><tr><td>code</td><td>String</td><td>M</td><td>Response Code from Pivot</td></tr><tr><td>message</td><td>String</td><td>M</td><td>Human readable message that represent response from Pivot</td></tr></tbody></table>