Sample - Slack Web API
GET/conversations.members

List conversation members

Lists the members of an existing conversation. Use limit and cursor to page through the member list, and authenticate with a token that has the conversations:read scope when authorization is required.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

4 parameters
tokenstringoptional
Authentication token for the request; it must provide the `conversations:read` scope.
channelstringoptional
The ID of the conversation whose members to retrieve.
limitintegeroptional
Maximum number of members to return; fewer may be returned even when more members remain.
cursorstringoptional
Pagination cursor from a previous response's `response_metadata.next_cursor`; omit it to retrieve the first page.

2 status codes
200Returns a response containing a unique `members` array of user IDs, an `ok` value of true, and `response_metadata.next_cursor` for pagination.
membersarray<UserID>required
okbooleanrequired
Allowed:true
response_metadataobjectrequired
defaultTypical error response when an invalid cursor is provided
callstackstringoptional
Note: PHP callstack is only visible in dev/qa
errorstringrequired
Allowed:channel_not_foundinvalid_limitinvalid_cursorfetch_members_failednot_authedinvalid_authaccount_inactiveinvalid_arg_nameinvalid_array_arginvalid_charsetinvalid_form_datainvalid_post_type
okbooleanrequired
Allowed:false

Error handling

channel must identify an existing conversation, and cursor must be a cursor returned in response_metadata.next_cursor when continuing pagination. Each returned member identifier follows the pattern ^[UW][A-Z0-9]{2,}$, and the token must provide the conversations:read scope.