Webex · Schema

BulkCreate

CallingCollaborationCommunicationEnterpriseMessagingVideo Conferencing

Properties

Name Type Description
schemas string "urn:cisco:codev:identity:contact:core:1.0".
contacts array Contains a list of contacts to be created/updated.
View JSON Schema on GitHub

JSON Schema

webex-bulkcreate-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/BulkCreate",
  "title": "BulkCreate",
  "type": "object",
  "required": [
    "schemas",
    "contacts"
  ],
  "properties": {
    "schemas": {
      "type": "string",
      "example": "urn:cisco:codev:identity:contact:core:1.0",
      "description": "\"urn:cisco:codev:identity:contact:core:1.0\"."
    },
    "contacts": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "source"
        ],
        "properties": {
          "contactId": {
            "type": "string",
            "example": "6847ee0f-5e9c-4403-9f0e-0aa8552f7828",
            "description": "Use this to update an existing contact."
          },
          "displayName": {
            "type": "string",
            "example": "John Andersen",
            "description": "The full name of the contact."
          },
          "firstName": {
            "type": "string",
            "example": "John",
            "description": "The first name of the contact."
          },
          "lastName": {
            "type": "string",
            "example": "Andersen",
            "description": "The last name of the contact."
          },
          "companyName": {
            "type": "string",
            "example": "Cisco Systems",
            "description": "The company the contact is working for."
          },
          "title": {
            "type": "string",
            "example": "GM",
            "description": "The contact's title."
          },
          "address": {
            "type": "string",
            "example": "{\\\"city\\\" : \\\"Milpitas\\\", \\\"country\\\" : \\\"US\\\", \\\"street\\\" : \\\"1099 Bird Ave.\\\", \\\"zipCode\\\" : \\\"99212\\\"}",
            "description": "Contact's address."
          },
          "avatarURL": {
            "type": "string",
            "example": "https://avatar-prod-us-east-2.webexcontent.com/default_avatar~1600",
            "description": "The URL to the person's avatar in PNG format."
          },
          "primaryContactMethod": {
            "type": "string",
            "enum": [
              "SIPADDRESS",
              "EMAIL",
              "PHONE",
              "IMS"
            ],
            "description": "The contact's primary contact method."
          },
          "source": {
            "type": "string",
            "enum": [
              "CH",
              "Webex4Broadworks"
            ],
            "description": "Where the data come from."
          },
          "emails": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "value": {
                  "type": "string",
                  "example": "[email protected]",
                  "description": "The email address."
                },
                "type": {
                  "type": "string",
                  "enum": [
                    "work",
                    "home",
                    "room",
                    "other"
                  ],
                  "description": "The type of the email."
                },
                "primary": {
                  "type": "boolean",
                  "description": "A Boolean value indicating the email status."
                }
              }
            },
            "description": "A list of the user's email addresses with an indicator of the user's primary email address."
          },
          "phoneNumbers": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "value": {
                  "type": "string",
                  "example": "400 123 1234",
                  "description": "The phone number."
                },
                "type": {
                  "type": "string",
                  "enum": [
                    "work",
                    "home",
                    "mobile",
                    "work_extension",
                    "fax",
                    "pager",
                    "other"
                  ],
                  "description": "The types of phone numbers."
                },
                "primary": {
                  "type": "boolean",
                  "example": true,
                  "description": "A Boolean value indicating the phone number's primary status."
                }
              }
            },
            "description": "A list of user's phone numbers with an indicator of primary to specify the user's main number."
          },
          "sipAddresses": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "value"
              ],
              "properties": {
                "value": {
                  "type": "string",
                  "example": "sipAddress value1",
                  "description": "The sipAddress value."
                },
                "type": {
                  "type": "string",
                  "enum": [
                    "enterprise",
                    "cloud-calling",
                    "personal-room"
                  ],
                  "description": "The type of the sipAddress."
                },
                "primary": {
                  "type": "boolean",
                  "example": true,
                  "description": "Designate the primary sipAddress."
                }
              }
            },
            "description": "The sipAddress values for the user."
          },
          "ims": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "value": {
                  "type": "string",
                  "example": "aim_account_ID",
                  "description": "The IMS account value."
                },
                "type": {
                  "type": "string",
                  "enum": [
                    "aim",
                    "cucm-jid",
                    "gtalk",
                    "icq",
                    "msn",
                    "qq",
                    "skype",
                    "webex-messenger-jid",
                    "webex-squared-jid",
                    "xmpp",
                    "yahoo",
                    "microsoft-sip-uri",
                    "xmpp-fed-jid"
                  ],
                  "description": "The type of the IMS."
                },
                "primary": {
                  "type": "boolean",
                  "example": true,
                  "description": "A Boolean value indicating the IMS account status."
                }
              }
            },
            "description": "Instant messaging addresses for the user."
          }
        }
      },
      "description": "Contains a list of contacts to be created/updated."
    }
  }
}