# Create Sharelist

`POST` `/v1/sharelists`

Create a new community stock list with an optional initial set of securities.

## Parameters

### Request Body

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | string | Yes | Sharelist name (required) |
| `cover` | string | Yes | Cover image URL (required) |
| `description` | string | Yes | Description |
| `securities` | array | No | Initial list of security symbols, e.g. `["AAPL.US", "NVDA.US"]` |

## Request Example

```bash
curl --request POST \
  --url 'https://openapi.longbridge.com/v1/sharelists' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{"description":"<description>","securities":[]}'
```

## Response

### Response Properties

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | int64 | Yes | ID of the newly created sharelist |

### Response JSON Example

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "id": 15922
  }
}
```
