# Create a mailing list member

Adds a new member to the mailing list.  For adding many list members, consider bulk upload endpoints "POST /v3/lists/{list_address}/members.json" or "members.csv".

Endpoint: POST /v3/lists/{list_address}/members
Version: 3.0.0
Security: basicAuth

## Path parameters:

  - `list_address` (string, required)
    The mailing list's address

## Request fields (multipart/form-data):

  - `address` (string)
    Valid email address specification.

  - `name` (string)
    An optional member name.

  - `vars` (object)
    JSON-encoded dictionary string with arbitrary parameters.

  - `subscribed` (boolean)
    Set the member as subscribed or not. Defaults to true.

  - `upsert` (boolean)
    Set to True to update member if present, False to raise error in case of a duplicate member. Defaults to false.

## Response 200 fields (application/json):

  - `member` (object)

  - `member.address` (string)
    The email address of the mailing list

  - `member.name` (string)
    The name of the mailing list

  - `member.vars` (object)
    A JSON-encoded dictionary string with arbitrary parameters, e.g. {"gender":"female","age":27}

  - `member.subscribed` (boolean)
    Whether the member is subscribed or not

  - `message` (string)
    Success message

## Response 400 fields (application/json):

  - `message` (string)
    Error message

## Response 429 fields (application/json):

  - `message` (string)
    Error message