> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chatsyncs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Team Member List

> List the people on a ChatSyncs account's team via the API, with their IDs, roles and whether each is active. Use when a developer needs a team_member_id to assign a conversation to someone, or asks how to see who is on the team.

Lists the people on your team. You need this to find the **`team_member_id`** that
[Assign Chat to Team Member](/developer-api/subscriber/assign-chat-to-team-member) asks for.

## Example Request

```bash theme={null}
curl --request GET \
  --url 'https://platform.chatsyncs.com/api/v1/users/team-member/list?apiToken=API-KEY'
```

Each team member has an `id`, `name`, `email`, `role_id`, `role` and a `status`: `"1"` for an active member
and `"0"` for an inactive one. Assign conversations to active members.

<Tip>
  No `phone_number_id` is needed — the team belongs to the account, not to one WhatsApp number.
  [Team Role List](/developer-api/user/list-team-roles) explains what each `role` can do.
</Tip>


## OpenAPI

````yaml GET /users/team-member/list
openapi: 3.1.0
info:
  title: ChatSyncs Developer API
  version: 1.0.0
  description: >-
    REST API for sending WhatsApp messages and managing subscribers through
    ChatSyncs.


    **Authentication.** Send your key as the `apiToken` parameter, or as
    `Authorization: Bearer <key>` — both work on every endpoint. A wrong key
    returns HTTP 401 `{"status":"0","message":"Unauthenticated."}`; no key at
    all redirects to the login page.


    **Methods.** Every endpoint accepts both GET and POST with the same
    parameters, except Upload Media, which is POST-only. Use POST for anything
    that changes data.


    **Errors.** Failures usually come back as HTTP 200 with `"status":"0"` and
    the reason in `message`, so always check `status`. `status` is the string
    `"1"` or `"0"` on most endpoints and a boolean on a few.


    **Lists.** Endpoints that return rows put them in `message` as a list; there
    is no `data` field (Custom Fields List is the exception and uses `data`).
servers:
  - url: https://platform.chatsyncs.com/api/v1
security: []
paths:
  /users/team-member/list:
    get:
      tags:
        - User API
      summary: Team Member List
      description: >-
        Lists the people on the account's team. `status` is `"1"` for active and
        `"0"` for inactive. Use an `id` as the `team_member_id` in Assign Chat
        to Team Member.
      operationId: listTeamMembers
      parameters:
        - name: apiToken
          in: query
          required: true
          schema:
            type: string
            example: API-KEY
          description: >-
            Your ChatSyncs API key (not a WhatsApp/Meta access token). [Where to
            find it](/developer-api/finding-ids#api-token-apitoken).
      responses:
        '200':
          description: >-
            Standard ChatSyncs response. `status` is `"1"` on success and `"0"`
            on failure.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    description: '`"1"` = success, `"0"` = failure.'
                  message:
                    type: array
                    description: The rows.
              examples:
                success:
                  summary: Success
                  value:
                    status: '1'
                    message:
                      - id: 300001
                        name: Support Agent
                        email: support@example.com
                        role_id: 16151
                        role: Support Role
                        status: '1'
                error:
                  summary: Error
                  value:
                    status: '0'
                    message: Invalid request.
        '401':
          description: >-
            `apiToken` is wrong. (With no token at all the API redirects to the
            login page with HTTP 302 instead of returning JSON.)
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                  message:
                    type: string
              examples:
                unauthenticated:
                  summary: Wrong apiToken
                  value:
                    status: '0'
                    message: Unauthenticated.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.