> 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/update-a-sub-account.md).

# Update a Sub-account

## Method and URL

<mark style="color:green;">`PUT`</mark> \[<mark style="color:orange;">BASE\_URL</mark>]/v1/sub-merchants/{uuid}

<mark style="color:orange;">`uuid`</mark> from the response body whenever you create a Sub-account

## Request

**Request Body**

```json
{
    "name": "Acme.inc",
    "description": "Updated Description",
    "logo": "some-url/company-logo.png",
    "merchantEmail": "admin@acme.inc",
    "merchantPhone": "08123456789",
    "address": "company address",
    "postCode": "123456"
}
```

**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="138.90234375">Requirement</th><th width="357">Description</th></tr></thead><tbody><tr><td>name</td><td>String</td><td>1-255</td><td>O</td><td>Name of the Sub-account</td></tr><tr><td>description</td><td>String</td><td>1-255</td><td>O</td><td>Description of the Sub-account</td></tr><tr><td>logo</td><td>String</td><td>1-255</td><td>O</td><td>cloud storage URL of the Sub-account logo</td></tr><tr><td>merchantEmail</td><td>String</td><td>0-255</td><td>O</td><td>Email Address of the Sub-account</td></tr><tr><td>merchantPhone</td><td>String</td><td>1-255</td><td>O</td><td>Phone Number of the Sub-account</td></tr><tr><td>address</td><td>String</td><td>1-254</td><td>O</td><td>Full Address of Sub-account's Company</td></tr><tr><td>postCode</td><td>String</td><td>1-20</td><td>O</td><td>Postal code of the Sub-account company address</td></tr></tbody></table>

## Response

**Response Body**

{% code fullWidth="false" %}

```json
{
  "code": "00",
  "message": "Success",
  "data": {
    "uuid": "d8361719-290b-4b80-8e75-8329321a4000",
    "name": "Reforza Corporation LTD",
    "shortName": "RCI5",
    "description": "Technologia Company",
    "address": "Menteng, Jakarta Pusat",
    "postCode": "60271",
    "logo": "some-url/company-logo.png",
    "merchantEmail": "reforza@corp.id",
    "merchantPhone": "081299996666",
    "picEmail": "admin@corp.inc",
    "picPhone": "081299996666",
    "picName": "Reforza",
    "picJobTitle": "owner",
    "businessType": "COMPANY",
    "businessStructure": "PERSEROAN TERBATAS",
    "businessCountry": "ID",
    "parentIndustry": "Airlines",
    "childIndustry": "Airlines, Air Carriers",
    "mcc": "4511",
    "countryOfEntity": "ID",
    "digitalStatus": "Digital",
    "parentId": "e485e01b-ff59-4a47-bb7d-9b39064f3388",
    "subAccountStatus": "CREATED"
  }
}
```

{% endcode %}

**Detail Parameter Response**

<table><thead><tr><th>Parameter</th><th width="116.04949951171875">Data Type</th><th width="129.0928955078125">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><tr><td>data</td><td>Object</td><td>M</td><td>Response Data from Pivot contains <a data-mention href="/pages/DapgzASTsSP7NRslMjME">/pages/DapgzASTsSP7NRslMjME</a></td></tr></tbody></table>