# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.elven.com/v3/openapi/create-source.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.