Webex · Schema

PostUser

CallingCollaborationCommunicationEnterpriseMessagingVideo Conferencing

Properties

Name Type Description
schemas array Input JSON schemas.
userName string A unique identifier for the user that authenticates the user in Webex. This must be set to the user's primary email address. No other user in Webex may have the same `userName` value, so this value mu
userType object User type.
title string The user's business title. Examples of a title is "Business Manager". "Senior Accountant", "Engineer" etc.
active boolean A boolean value of "true" or "false" indicating whether the user is allowed to login to Webex.
roles array List of roles assigned to the user.
preferredLanguage string User's preferred language. Acceptable values are based on the [ISO-696](http://www.loc.gov/standards/iso639-2/php/code_list.php) and [ISO-3166](https://www.iso.org/obp/ui/#search) with the 2 letter la
locale string The user's locale which represents the user's currency, time format, and numerical representations. Acceptable values are based on the [ISO-696](http://www.loc.gov/standards/iso639-2/php/code_list.php
timezone string The user's time zone specified in the [IANA timezone](https://nodatime.org/timezones) timezone format, for example, "America/Los_Angeles".
profileUrl string A fully qualified URL pointing to a page representing the user's online profile.
externalId string User identifier provided by an external provisioning source.
displayName string The name displayed for the user in Webex.
nickName string A casual name of the user. For example, Bob when the user's formal name is Robert.
name object The components of the user's real name.
phoneNumbers array A list of user's phone numbers.
photos array A list of photo objects for the user.
addresses array User's physical mailing address.
emails array A list of the user's email addresses, including primary and alternative emails. The primary work email address must match the value of the user's username.
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User object SCIM2 enterprise extension
urn:scim:schemas:extension:cisco:webexidentity:2.0:User object The Cisco extension of SCIM 2.
View JSON Schema on GitHub

JSON Schema

webex-postuser-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/PostUser",
  "title": "PostUser",
  "type": "object",
  "required": [
    "schemas",
    "userName",
    "userType"
  ],
  "properties": {
    "schemas": {
      "type": "array",
      "items": {
        "type": "string",
        "example": "urn:ietf:params:scim:schemas:core:2.0:User,urn:ietf:params:scim:schemas:extension:enterprise:2.0:User,urn:scim:schemas:extension:cisco:webexidentity:2.0:User"
      },
      "description": "Input JSON schemas."
    },
    "userName": {
      "type": "string",
      "example": "[email protected]",
      "description": "A unique identifier for the user that authenticates the user in Webex.  This must be set to the user's primary email address.  No other user in Webex may have the same `userName` value, so this value must be unique within Webex."
    },
    "userType": {
      "$ref": "#/components/schemas/UserTypeObject",
      "description": "User type."
    },
    "title": {
      "type": "string",
      "example": "Sales manager",
      "description": "The user's business title.  Examples of a title is \"Business Manager\". \"Senior Accountant\", \"Engineer\" etc."
    },
    "active": {
      "type": "boolean",
      "example": true,
      "description": "A boolean value of \"true\" or \"false\" indicating whether the user is allowed to login to Webex."
    },
    "roles": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/RoleObject"
      },
      "description": "List of roles assigned to the user."
    },
    "preferredLanguage": {
      "type": "string",
      "example": "en_US",
      "description": "User's preferred language. Acceptable values are based on the [ISO-696](http://www.loc.gov/standards/iso639-2/php/code_list.php) and [ISO-3166](https://www.iso.org/obp/ui/#search) with the 2 letter language code followed by an _ and then the 2 letter country code.  Examples are:\n\n                                    en_US : for United States English or fr_FR for Parisian French."
    },
    "locale": {
      "type": "string",
      "example": "en_US",
      "description": "The user's locale which represents the user's currency, time format, and numerical representations.  Acceptable values are based on the [ISO-696](http://www.loc.gov/standards/iso639-2/php/code_list.php) and [ISO-3166](https://www.iso.org/obp/ui/#search) with the 2 letter language code followed by an _ and then the 2 letter country code.  Examples are:\n\n                         en_US : for United States English or fr_FR for Parisian French."
    },
    "timezone": {
      "type": "string",
      "example": "America/Los_Angeles",
      "description": "The user's time zone specified in the [IANA timezone](https://nodatime.org/timezones) timezone format, for example, \"America/Los_Angeles\"."
    },
    "profileUrl": {
      "type": "string",
      "example": "https://jojowiki.com/Jonathan_Joestar",
      "description": "A fully qualified URL pointing to a page representing the user's online profile."
    },
    "externalId": {
      "type": "string",
      "example": "externalIdValue",
      "description": "User identifier provided by an external provisioning source."
    },
    "displayName": {
      "type": "string",
      "example": "Mr. Jonathan Jane Joestar, III",
      "description": "The name displayed for the user in Webex."
    },
    "nickName": {
      "type": "string",
      "example": "JoJo",
      "description": "A casual name of the user. For example, Bob when the user's formal name is Robert."
    },
    "name": {
      "$ref": "#/components/schemas/NameObject",
      "description": "The components of the user's real name."
    },
    "phoneNumbers": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/PhoneNumberObject"
      },
      "description": "A list of user's phone numbers."
    },
    "photos": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/PhotoObject"
      },
      "description": "A list of photo objects for the user."
    },
    "addresses": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/AddressObject"
      },
      "description": "User's physical mailing address."
    },
    "emails": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/EmailObject"
      },
      "description": "A list of the user's email addresses, including primary and alternative emails. The primary work email address must match the value of the user's username."
    },
    "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
      "type": "object",
      "properties": {
        "costCenter": {
          "type": "string",
          "example": "costCenter 123",
          "description": "Name of a cost center."
        },
        "organization": {
          "type": "string",
          "example": "Cisco webexidentity",
          "description": "Name of an organization."
        },
        "division": {
          "type": "string",
          "example": "division 456",
          "description": "Name of a division."
        },
        "department": {
          "type": "string",
          "example": "department 789",
          "description": "Name of a department."
        },
        "employeeNumber": {
          "type": "string",
          "example": "518-8888-888",
          "description": "Numeric or alphanumeric identifier assigned to a person, typically based on the order of hire or association with an organization."
        },
        "manager": {
          "type": "object",
          "required": [
            "value"
          ],
          "properties": {
            "value": {
              "type": "string",
              "example": "b5717a4a-0169-43b2-ac3c-db20ba4e72cd",
              "description": "Webex Identity assigned user identifier of the user's manager. The manager must belong to the same org as the user."
            }
          },
          "description": "The user's manager."
        }
      },
      "description": "SCIM2 enterprise extension"
    },
    "urn:scim:schemas:extension:cisco:webexidentity:2.0:User": {
      "type": "object",
      "required": [
        "accountStatus"
      ],
      "properties": {
        "accountStatus": {
          "$ref": "#/components/schemas/AccountStatusObject",
          "description": "An array of additional information about a user's status."
        },
        "sipAddresses": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/SipAddressObject"
          },
          "description": "`sipAddress` values for the user."
        },
        "managedOrgs": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/ManagedOrgsObject"
          },
          "description": "Organizations that the user can manage."
        },
        "managedGroups": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/ManagedGroupsObject"
          },
          "description": "Groups that the user can manage."
        },
        "extensionAttribute*": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "The extension attributes of the user. Postfix support from 1 to 15, for example: \"extensionAttribute1\", \"extensionAttribute2\", ..., \"extensionAttribute15\"."
        },
        "externalAttribute*": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/ExternalAttributeObject"
          },
          "description": "The external attributes of the user. Postfix support from 1 to 15, for example: \"externalAttribute1\", \"externalAttribute2\", ..., \"externalAttribute15\"."
        }
      },
      "description": "The Cisco extension of SCIM 2."
    }
  }
}