Book a demo

Get Person

webex.get_person
ActionChat & messagingconnection required

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

Fetch one Webex person by id.

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

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

FieldTypeRequiredDefaultConstraintsExample
person_id
Id of the person to fetch, from webex.list_people or a message.
stringYes———

Output

One shape.

result

FieldTypeExample
id
The person id — pass it to webex.create_membership.
string—
emails
The person's email addresses; the first is the primary one.
array—
display_name
The person's display name.
string—
first_name
The person's first name.
string—
last_name
The person's last name.
string—
avatar
URL of the person's avatar image.
string—
org_id
Id of the person's organisation.
string—
type
'person', 'bot' or 'appuser'.
string—
status
Presence, e.g. active, meeting, DoNotDisturb — when shared.
string—
timezone
The person's timezone, e.g. America/Denver.
string—
last_activity
When they were last active (ISO-8601).
string—
created
When the account was created (ISO-8601).
string—
{
  "avatar": "",
  "created": "",
  "display_name": "",
  "emails": [],
  "first_name": "",
  "id": "",
  "last_activity": "",
  "last_name": "",
  "org_id": "",
  "status": "",
  "timezone": "",
  "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.
  • Presence fields (status, last_activity) come back only for people in your own organisation who have not turned status sharing off.

Related Cisco Webex nodes

See Get Person 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