Webex (Preview)
Webex enables continuous teamwork with video meetings, group messaging, file sharing, and white boarding. Always available. Cisco secure. With the Webex connector, you can send and receive messages, manage files, and manage spaces and teams.
This connector is available in the following products and regions:
| Service | Class | Regions |
|---|---|---|
| Logic Apps | Standard | All Logic Apps regions except the following: - Azure Government regions - Azure China regions - US Department of Defense (DoD) |
| Power Automate | Standard | All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Power Apps | Standard | All Power Apps regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Contact | |
|---|---|
| Name | Webex Support |
| devsupport@webex.com |
| Connector Metadata | |
|---|---|
| Publisher | Cisco |
| Website | https://www.webex.com |
| Privacy policy | https://www.cisco.com/c/en/us/about/legal/privacy-full.html |
| Categories | Communication;Collaboration |
Throttling Limits
| Name | Calls | Renewal Period |
|---|---|---|
| API calls per connection | 100 | 60 seconds |
Actions
| Add Member to Space |
Add a member to an existing space |
| Add Member to Team |
Add a member to a team |
| Create Space |
Create space or team space |
| Get Message Details |
Shows details for a message, by message ID. |
| Get Messages |
Get a list of recent messages for a space |
| Get My Own Details |
Lookup your own details |
| Get People |
Lookup details and presence information for people in your organization |
| Get Space Details |
Return details of a given space |
| Get Spaces List |
This action retrieves a list of spaces |
| Send a Message |
Send a message to webex |
Add Member to Space
Add a member to an existing space
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Moderator
|
isModerator | True | boolean |
Is moderator? |
|
Email
|
personEmail | string |
Email address |
|
|
Person ID
|
personId | string |
Person ID of the new member |
|
|
Space
|
roomId | True | string |
Select a space |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
created
|
created | date-time |
created |
|
id
|
id | string |
id |
|
isModerator
|
isModerator | boolean |
isModerator |
|
isMonitor
|
isMonitor | boolean |
isMonitor |
|
personDisplayName
|
personDisplayName | string |
personDisplayName |
|
personEmail
|
personEmail | string |
personEmail |
|
personId
|
personId | string |
personId |
|
personOrgId
|
personOrgId | string |
personOrgId |
|
roomId
|
roomId | string |
roomId |
Add Member to Team
Add a member to a team
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Moderator
|
isModerator | True | boolean |
Is Moderator? |
|
Email
|
personEmail | string |
Email address |
|
|
Person ID
|
personId | string |
Person ID of the new member |
|
|
Team
|
teamId | True | string |
Select a team |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
created
|
created | date-time |
created |
|
id
|
id | string |
id |
|
isModerator
|
isModerator | boolean |
isModerator |
|
personDisplayName
|
personDisplayName | string |
personDisplayName |
|
personEmail
|
personEmail | string |
personEmail |
|
personId
|
personId | string |
personId |
|
personOrgId
|
personOrgId | string |
personOrgId |
|
teamId
|
teamId | string |
teamId |
Create Space
Create space or team space
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Team
|
teamId | string |
Optionally select a team |
|
|
Title
|
title | True | string |
Space Title |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
created
|
created | date-time |
created |
|
creatorId
|
creatorId | string |
creatorId |
|
id
|
id | string |
id |
|
isLocked
|
isLocked | boolean |
isLocked |
|
lastActivity
|
lastActivity | date-time |
lastActivity |
|
title
|
title | string |
title |
|
type
|
type | string |
type |
Get Message Details
Shows details for a message, by message ID.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Message ID
|
messageId | True | string |
The message ID |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
created
|
created | string |
created |
|
files
|
files | array of string |
files |
|
id
|
id | string |
id |
|
markdown
|
markdown | string |
markdown |
|
mentionedGroups
|
mentionedGroups | array of string |
mentionedGroups |
|
mentionedPeople
|
mentionedPeople | array of string |
mentionedPeople |
|
personEmail
|
personEmail | string |
personEmail |
|
personId
|
personId | string |
personId |
|
roomId
|
roomId | string |
roomId |
|
roomType
|
roomType | string |
roomType |
|
text
|
text | string |
text |
|
toPersonEmail
|
toPersonEmail | string |
toPersonEmail |
|
toPersonId
|
toPersonId | string |
toPersonId |
Get Messages
Get a list of recent messages for a space
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Space
|
roomId | True | string |
List messages in a space for a given space ID |
|
Mentioned People
|
mentionedPeople | string |
List messages where the caller is mentioned by specifying "me" or the caller personId. |
|
|
Before Message
|
beforeMessage | string |
List messages sent before a message, by ID. |
|
|
Before
|
before | string |
List messages sent before a date and time, in ISO8601 format. |
|
|
Max
|
max | integer |
Limit the maximum number of messages in the response. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
items
|
items | array of object |
items |
|
created
|
items.created | date-time |
created |
|
id
|
items.id | string |
id |
|
personEmail
|
items.personEmail | string |
personEmail |
|
personId
|
items.personId | string |
personId |
|
roomId
|
items.roomId | string |
roomId |
|
roomType
|
items.roomType | string |
roomType |
|
text
|
items.text | string |
text |
Get My Own Details
Lookup your own details
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
avatar
|
avatar | string |
avatar |
|
created
|
created | string |
created |
|
displayName
|
displayName | string |
displayName |
|
emails
|
emails | array of string |
emails |
|
firstName
|
firstName | string |
firstName |
|
id
|
id | string |
id |
|
lastActivity
|
lastActivity | string |
lastActivity |
|
lastName
|
lastName | string |
lastName |
|
nickName
|
nickName | string |
nickName |
|
orgId
|
orgId | string |
orgId |
|
phoneNumbers
|
phoneNumbers | array of object |
phoneNumbers |
|
type
|
phoneNumbers.type | string |
type |
|
value
|
phoneNumbers.value | string |
value |
|
status
|
status | string |
status |
|
type
|
type | string |
type |
Get People
Lookup details and presence information for people in your organization
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Person ID
|
id | string |
List people by ID. Accepts up to 85 person IDs separated by commas. |
|
|
Email
|
string |
List people with this email address |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
items
|
items | array of object |
items |
|
avatar
|
items.avatar | string |
avatar |
|
created
|
items.created | string |
created |
|
displayName
|
items.displayName | string |
displayName |
|
emails
|
items.emails | array of string |
emails |
|
firstName
|
items.firstName | string |
firstName |
|
id
|
items.id | string |
id |
|
lastActivity
|
items.lastActivity | string |
lastActivity |
|
lastName
|
items.lastName | string |
lastName |
|
nickName
|
items.nickName | string |
nickName |
|
orgId
|
items.orgId | string |
orgId |
|
phoneNumbers
|
items.phoneNumbers | array of object |
phoneNumbers |
|
type
|
items.phoneNumbers.type | string |
type |
|
value
|
items.phoneNumbers.value | string |
value |
|
status
|
items.status | string |
status |
|
type
|
items.type | string |
type |
|
notFoundIds
|
notFoundIds | array of string |
notFoundIds |
Get Space Details
Return details of a given space
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Space
|
roomId | True | string |
Select a space |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
created
|
created | date-time |
created |
|
creatorId
|
creatorId | string |
creatorId |
|
id
|
id | string |
id |
|
isLocked
|
isLocked | boolean |
isLocked |
|
lastActivity
|
lastActivity | date-time |
lastActivity |
|
title
|
title | string |
title |
|
type
|
type | string |
type |
Get Spaces List
This action retrieves a list of spaces
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Max Results
|
max | integer |
Maximum number of spaces to return |
|
|
Type of space
|
type | string |
(group) only include group spaces, (direct) only include 1 to 1 spaces, returns all if not specified |
|
|
Sort By
|
sortBy | string |
(id) the space id, (lastactivity) the last activity timestamp, (created) space creation date |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
items
|
items | array of object |
items |
|
created
|
items.created | date-time |
created |
|
creatorId
|
items.creatorId | string |
creatorId |
|
id
|
items.id | string |
id |
|
isLocked
|
items.isLocked | boolean |
isLocked |
|
lastActivity
|
items.lastActivity | date-time |
lastActivity |
|
title
|
items.title | string |
title |
|
type
|
items.type | string |
type |
Send a Message
Send a message to webex
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
files
|
files | array of string |
files |
|
|
Text
|
markdown | string |
Message, in markdown format |
|
|
Space
|
roomId | string |
Select a recipient space |
|
|
text
|
text | string |
Message Text, in plain text, used for clients that do not support markdown |
|
|
Email
|
toPersonEmail | string |
The email address of the recipient when sending a private 1:1 message |
|
|
Person ID
|
toPersonId | string |
The ID of the recipient when sending a 1:1 message |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
created
|
created | date-time |
created |
|
id
|
id | string |
id |
|
personEmail
|
personEmail | string |
personEmail |
|
personId
|
personId | string |
personId |
|
roomId
|
roomId | string |
roomId |
|
roomType
|
roomType | string |
roomType |
|
text
|
text | string |
text |
|
toPersonEmail
|
toPersonEmail | string |
toPersonEmail |
Triggers
| When a membership is created |
Someone joined a room that you're in or you've been added to a new room |
| When a membership is deleted |
Someone left or was kicked out of a room that you're in, or you left or were removed from a room; only triggers for group rooms, not 1-to-1 rooms |
| When a membership is updated |
Someone's membership was updated in a room that you're in; primarily used to detect moderator changes |
| When a message is created |
New message posted into a room that you're in |
| When a message is deleted |
A message was deleted from a room that you're in |
| When a space is created |
A new space was created by you or one of your integrations |
| When a space is updated |
A space that you're in was updated; primarily used to detect when a space becomes Locked or Unlocked |
When a membership is created
Someone joined a room that you're in or you've been added to a new room
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
created
|
data.created | string |
created |
|
|
data.id | string |
id |
|
isModerator
|
data.isModerator | boolean |
isModerator |
|
isMonitor
|
data.isMonitor | boolean |
isMonitor |
|
personDisplayName
|
data.personDisplayName | string |
personDisplayName |
|
personEmail
|
data.personEmail | string |
personEmail |
|
personId
|
data.personId | string |
personId |
|
personOrgId
|
data.personOrgId | string |
personOrgId |
|
|
data.roomId | string |
spaceId |
When a membership is deleted
Someone left or was kicked out of a room that you're in, or you left or were removed from a room; only triggers for group rooms, not 1-to-1 rooms
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
created
|
data.created | string |
created |
|
id
|
data.id | string |
id |
|
isModerator
|
data.isModerator | boolean |
isModerator |
|
isMonitor
|
data.isMonitor | boolean |
isMonitor |
|
personDisplayName
|
data.personDisplayName | string |
personDisplayName |
|
personEmail
|
data.personEmail | string |
personEmail |
|
personId
|
data.personId | string |
personId |
|
personOrgId
|
data.personOrgId | string |
personOrgId |
|
|
data.roomId | string |
spaceId |
When a membership is updated
Someone's membership was updated in a room that you're in; primarily used to detect moderator changes
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
created
|
data.created | string |
created |
|
id
|
data.id | string |
id |
|
isModerator
|
data.isModerator | boolean |
isModerator |
|
isMonitor
|
data.isMonitor | boolean |
isMonitor |
|
personDisplayName
|
data.personDisplayName | string |
personDisplayName |
|
personEmail
|
data.personEmail | string |
personEmail |
|
personId
|
data.personId | string |
personId |
|
personOrgId
|
data.personOrgId | string |
personOrgId |
|
|
data.roomId | string |
spaceId |
When a message is created
New message posted into a room that you're in
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
created
|
data.created | string |
created |
|
id
|
data.id | string |
id |
|
personEmail
|
data.personEmail | string |
personEmail |
|
personId
|
data.personId | string |
personId |
|
|
data.roomId | string |
spaceId |
When a message is deleted
A message was deleted from a room that you're in
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
created
|
data.created | string |
created |
|
id
|
data.id | string |
id |
|
personEmail
|
data.personEmail | string |
personEmail |
|
personId
|
data.personId | string |
personId |
|
|
data.roomId | string |
spaceId |
When a space is created
A new space was created by you or one of your integrations
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
created
|
data.created | string |
created |
|
creatorId
|
data.creatorId | string |
creatorId |
|
id
|
data.id | string |
id |
|
isLocked
|
data.isLocked | boolean |
isLocked |
|
lastActivity
|
data.lastActivity | string |
lastActivity |
|
teamId
|
data.teamId | string |
teamId |
|
title
|
data.title | string |
title |
|
type
|
data.type | string |
type |
When a space is updated
A space that you're in was updated; primarily used to detect when a space becomes Locked or Unlocked
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
created
|
data.created | string |
created |
|
creatorId
|
data.creatorId | string |
creatorId |
|
id
|
data.id | string |
id |
|
isLocked
|
data.isLocked | boolean |
isLocked |
|
lastActivity
|
data.lastActivity | string |
lastActivity |
|
teamId
|
data.teamId | string |
teamId |
|
title
|
data.title | string |
title |
|
type
|
data.type | string |
type |