# Create Account

### API Overview

This API allows you to create a new account to the system.

* **Request Method：**`POST`
* **Request URL：**`https://openapi.elven.com/open/v3/entityAccount`

### Request Headers

<table><thead><tr><th width="202">Parameter Name</th><th width="90">Type</th><th width="100">Required</th><th>Description</th></tr></thead><tbody><tr><td>elven-api-key</td><td>String</td><td>Yes</td><td>The API key assigned to you</td></tr><tr><td>elven-api-sign</td><td>String</td><td>Yes</td><td>Request signature, used to verify the legitimacy of the request</td></tr><tr><td>elven-api-timestamp</td><td>String</td><td>Yes</td><td>Request timestamp, in milliseconds</td></tr></tbody></table>

[View Details](https://docs.elven.com/v3/~/changes/YkdBoYHdjwadymwIANKf/openapi/obtaining-api-authorization?r=LJbAoiJKFX1i7Py2GCYr)

### Request Parameters

#### Body Parameters (JSON Format)

<table><thead><tr><th width="192">Parameter Name</th><th width="89">Type</th><th width="105">Required</th><th>Description</th></tr></thead><tbody><tr><td>name</td><td>String</td><td>Yes</td><td>The name of the account.</td></tr><tr><td>platformId</td><td>String</td><td>Yes</td><td>The platform identifier associated with the account.</td></tr><tr><td>identity</td><td>String</td><td>Yes</td><td>Account address or ID.</td></tr><tr><td>memo</td><td>String</td><td>No</td><td>Additional information or notes about the account.</td></tr><tr><td>auxiliaryValueList</td><td>Array</td><td>No</td><td>A list of auxiliary accounting fields,only supports Custom Options type.</td></tr></tbody></table>

**auxiliaryValueList (array, optional)**&#x20;

<table><thead><tr><th width="197">Parameter Name</th><th width="86">Type</th><th width="103">Required</th><th>Description</th></tr></thead><tbody><tr><td>name</td><td>String</td><td>Yes</td><td>Auxiliary code name</td></tr><tr><td>value</td><td>String</td><td>Yes</td><td>“The corresponding value, which will be automatically created if it does not exist.</td></tr></tbody></table>

#### Example Request

```json
{
    "name": "account1",
    "platformId": "zw1dbgFCXmZctjq06FbR4W3Gk8EBn2Iwz",
    "identity": "0xaaa",
    "memo": "this is memo",
    "auxiliaryValueList": [
        {
            "name": "counterparty",
            "value": "Counterparty1"
        },
        {
            "name": "text1",
            "value": "value1"
        }
    ]
}
```

### Response Parameters

<table><thead><tr><th width="187">Parameter Name</th><th width="109">Type</th><th>Description</th></tr></thead><tbody><tr><td>entityAccountId</td><td>String</td><td>Account  Primary Key</td></tr><tr><td>name</td><td>String</td><td>Account Name</td></tr><tr><td>platformId</td><td>String</td><td>PlatformId Primary Key</td></tr><tr><td>identity</td><td>String</td><td>Account Address</td></tr><tr><td>memo</td><td>String</td><td>memo</td></tr></tbody></table>

#### Example Response

```json
{
    "entityAccountId": "xxxx",
    "name": "account1",
    "platformId": "xxx",
    "identity": "xxx",
    "memo": ""
}
```

### **Notes**

* The following headers are required for all requests to ensure security and validity: elven-api-key,elven-api-sign,elven-api-timestamp
* The auxiliaryValueList only supports fields of the Custom Options type.
* If the value for an auxiliary field does not exist, the system will automatically create it.