# Create Source

### API Overview

This API allows you to create a new **Source** under an existing account in the system.

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

### 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="202">Parameter Name</th><th width="94">Type</th><th width="103">Required</th><th>Description</th></tr></thead><tbody><tr><td>name</td><td>String</td><td>Yes</td><td>The name of the source to be created.</td></tr><tr><td>entityAccountId</td><td>String</td><td>Yes</td><td>The primary key of the account under which the source will be created.</td></tr></tbody></table>

#### Example Request

```json
{
    "name": "MySource",
    "entityAccountId": "abc123"
}
```

### Response Parameters

<table><thead><tr><th width="204">Parameter Name</th><th width="98">Type</th><th>Description</th></tr></thead><tbody><tr><td>sourceId</td><td>String</td><td>The primary key of the newly created source.</td></tr><tr><td>name</td><td>String</td><td>The name of the source.</td></tr><tr><td>entityAccountId</td><td>String</td><td>The primary key of the account associated with the source.</td></tr></tbody></table>

#### Example Response

```json
{
    "sourceId": "def456",
    "name": "MySource",
    "entityAccountId": "abc123"
}
```

### **Notes**

* The following headers are required for all requests to ensure security and validity: elven-api-key,elven-api-sign,elven-api-timestamp
* Both name and entityAccountId are mandatory fields in the request body and cannot be left empty.
* Upon successful creation, the system will return a unique sourceId, which can be used for subsequent operations.