# Create Group

`POST` `/v1/watchlist/groups`

> **Quote Permission Required · Free**
> Included with OpenAPI activation — no extra purchase needed.
> _OpenAPI quote perms are separate from App/Web perms_

Create watched group

## Parameters

### Request Body

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | string | Yes | Watchlist group name. |
| `securities` | array | No | Optional list of security symbols to pre-populate the group, e.g. `["AAPL.US","700.HK"]`. |

## Request Example

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

## Response

### Response Properties

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | integer | No | Group ID |

### Response JSON Example

```json
{
  "code": 0,
  "data": {
    "id": 10086
  }
}
```
