# Add Members

**POST** `/v1/lists/{{list_id}}/members`

Adds one or more members to a list. Members can be identified by `user_id`, `email`, or both. If an email is provided without a matching user and `first_name`/`last_name` are given, a new user is created with the specified `type`.

### Request fields

**members** `array` `required` — Array of member objects.  
**members[].email** `string` `optional` — Email address of the member.  
**members[].user_id** `number` `optional` — ID of an existing platform user.  
**members[].first_name** `string` `optional` — First name (used if creating a new user).  
**members[].last_name** `string` `optional` — Last name (used if creating a new user).  
**members[].type** `string` `optional` — Member type: `newsletter`, `contact`, `customer`, or any custom string. Defaults to `newsletter`.

### Response fields

**added** Number of members added in this request.  
**member_count** Total members in the list after this operation.