---
title: "Add List Member"
method: POST
path: "/list/add_member"
tags: ["Write Actions"]
---

# Add List Member

`POST /list/add_member`

## Request

- Base URL: `https://api.twitterapis.com/twitter`
- URL: `https://api.twitterapis.com/twitter/list/add_member`
- Auth: HTTP bearer

Add an account to a List owned by your registered X session. Returns the List's member_count as proof the membership change landed. Cost: $0.0008 per call.

## Request body

- object
  - `list_id` string, required: Numeric ID of the List you own.
  - `user_id` string, required: Numeric ID of the account to add.

## Response `200`

Add one account to a Twitter/X List you own.

- object
  - `ok` boolean: True when the membership change applied.
  - `action` string: The membership action performed.
  - `list_id` string: The List the write targeted.
  - `user_id` string: The account the write targeted.
  - `member_count` integer, nullable: The List's member count after the write, read back from X as proof. Null when X returned no list object, which is the not-applied signal.
  - `list` object: The List object X returned after the write.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `402`: Insufficient credits
- `403`: Forbidden
- `404`: Not found
- `429`: Rate limited
- `5XX`: Server error

---

[API](https://skmtc.dev/twitterapis/apis/twitterapis-api.md) · [All operations](https://skmtc.dev/twitterapis/apis/twitterapis-api/llms.txt) · [OpenAPI document](https://skmtc.dev/twitterapis/apis/twitterapis-api/revisions/a33ce0fedb3c?raw)