Book a demo

List Memberships

webex.list_memberships
ActionChat & messagingconnection required

Calls the Cisco Webex API with the connection's credentials.

List who is in a Webex space, or which spaces a person is in.

Ask about Cisco WebexAll Cisco Webex nodesProvider API docs ↗

Connection

Required
Yes — the node will not save without one
Auth type
Bearer token
Providers
Cisco Webex
Secret shape
the Webex access token, or {"access_token": "…"}
Resolved by
config.connection_id, else node.connection_id

Configuration

4 fields, none required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.

FieldTypeRequiredDefaultConstraintsExample
room_id
Only the memberships of this space. Leave blank to list your own.
stringNo——Y2lzY29zcGFyazovL3VzL1JPT00vYmJjZWIxYWQtNDNmMS0zYjU4LTkxNDctZjE0YmIwYzRkMTU0
person_email
Only this person's membership. Webex needs room_id alongside it.
stringNo—email formatjohn.andersen@example.com
person_id
Only this person id's membership. Webex needs room_id alongside it.
stringNo———
max_results
How many memberships to ask for.
numberNo100≥ 1—

Example configuration

Every value below is the contract’s own example or default — nothing invented.

{
  "max_results": 100,
  "person_email": "john.andersen@example.com",
  "room_id": "Y2lzY29zcGFyazovL3VzL1JPT00vYmJjZWIxYWQtNDNmMS0zYjU4LTkxNDctZjE0YmIwYzRkMTU0"
}

Output

One shape.

result

FieldTypeExample
items[].id
The membership id — pass it to webex.delete_membership.
string—
items[].room_id
Id of the space this membership is in.
string—
items[].person_id
Id of the member.
string—
items[].person_email
Email of the member.
string—
items[].person_display_name
The member's display name.
string—
items[].person_org_id
Id of the member's organisation.
string—
items[].is_moderator
True when the member moderates the space.
boolean—
items[].room_type
'group' for a space, 'direct' for a 1:1 room.
string—
items[].created
When the membership was created (ISO-8601).
string—
count
How many rows this page carries.
number—
{
  "count": 0,
  "items": [
    {
      "created": "",
      "id": "",
      "is_moderator": false,
      "person_display_name": "",
      "person_email": "",
      "person_id": "",
      "person_org_id": "",
      "room_id": "",
      "room_type": ""
    }
  ]
}

Notes

  • The connection's token is the actor: a bot token only sees the spaces the bot has been added to, and a personal or integration token acts as that user.
  • Filtering by person_email or person_id requires room_id as well, unless the token belongs to a compliance officer.
  • One page only: Webex paginates with an RFC 5988 Link header, which this node does not follow — narrow the filters or raise max_results instead.

Related Cisco Webex nodes

See List Memberships run in a workflow.

In a technical demo we add the Cisco Webex connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.

Book a technical demoTalk to sales