{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":545,"path":"api-reference/rest-apis/scim-api.md","title":"System for Cross-domain Identity Management \\(SCIM\\) API","bundle":null,"doc_type":null,"release":"australia","body":"\n# System for Cross-domain Identity Management \\(SCIM\\) API\n\nThe System for Cross-domain Identity Management \\(SCIM\\) API provides endpoints to create, read, update, and delete operations on users and groups using the SCIM protocol.\n\nThe SCIM protocol is an application-level HTTP-based protocol based on the HTTP \\[[RFC7230](https://datatracker.ietf.org/doc/html/rfc7230)\\] standard. Use this API for provisioning and managing identity data, such as users and groups, on the web and in cross-domain environments, such as enterprise-to-cloud service providers or inter-cloud scenarios.\n\nTo access this API, you must activate the SCIM v2 - ServiceNow® Cross-domain Identity Management \\(com.snc.integration.scim2\\) plugin.\n\n## Resource mapping\n\nThe SCIM service has six resources:\n\n-   User \\(core and extension\\)\n-   Group \\(core and extension\\)\n-   Company\n-   CostCenter\n-   Department\n-   Location\n\nMost of the attributes in these SCIM resources map to corresponding fields in an existing ServiceNow table. The following tables define these mappings. Attributes that do not correspond to fields in existing ServiceNow tables map to two SCIM-specific tables. For additional information on these tables, see [SCIM-specific tables](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-apis/scim-api.md).\n\nThe SCIM User resource has both core \\(schema: urn:ietf:params:scim:schemas:core:2.0:User\\) and extension \\(urn:ietf:params:scim:schemas:extension:servicenow:2.0:User\\) schemas. Most of the User core and extension schema attributes map to the User \\[sys\\_user\\] table.\n\n|SCIM attribute name|User field name|\n|-------------------|---------------|\n|active|active|\n|addresses.country|country|\n|addresses.default.country|country|\n|addresses.home.country|country|\n|addresses.locality|city|\n|addresses.default.locality|city|\n|addresses.home.locality|city|\n|addresses.postalCode|zip|\n|addresses.default.postalCode|zip|\n|addresses.home.postalCode|zip|\n|addresses.region|state|\n|addresses.default.region|state|\n|addresses.home.region|state|\n|addresses.streetAddress|street|\n|addresses.default.streetAddress|street|\n|addresses.home.streetAddress|street|\n|displayName|name|\n|emails.value|email|\n|emails.default.value|email|\n|emails.work.value|email|\n|id|sys\\_id|\n|meta.created|sys\\_created\\_on|\n|meta.lastModified|sys\\_updated\\_on|\n|name.familyName|last\\_name|\n|name.givenName|first\\_name|\n|name.honorificPrefix|introduction|\n|name.middleName|middle\\_name|\n|phoneNumbers.value|phone|\n|phoneNumbers.home.value|home\\_phone|\n|phoneNumbers.mobile.value|mobile\\_phone|\n|phoneNumbers.work.value|phone|\n|preferredLanguage|preferred\\_language|\n|timezone|time\\_zone|\n|title|title|\n|userName|user\\_name|\n\n|SCIM attribute name|Sys Scim User field name|\n|-------------------|------------------------|\n|externalId|external\\_id|\n\nThe SCIM User extended schema \\(urn:ietf:params:scim:schemas:extension:servicenow:2.0:User\\) maps to the User \\[sys\\_user\\] table.\n\n|SCIM attribute name|User field name|\n|-------------------|---------------|\n|company.name|company.name|\n|company.value|company.sys\\_id|\n|costCenter.name|cost\\_center.name|\n|costCenter.value|cost\\_center.sys\\_id|\n|department.name|department.name|\n|department.value|department.sys\\_id|\n|employeeNumber|employee\\_number|\n|gender|gender|\n|location.name|location.name|\n|location.value|location.sys\\_id|\n|manager.displayName|manager.name|\n|manager.value|manager.sys\\_id|\n\nThe SCIM Group resource schema \\(urn:ietf:params:scim:schemas:core:2.0:Group\\) maps to the Group \\[sys\\_user\\_group\\] table.\n\n|SCIM attribute name|Group field name|\n|-------------------|----------------|\n|displayName|name|\n|id|sys\\_id|\n|meta.created|sys\\_created\\_on|\n|meta.lastModified|sys\\_updated\\_on|\n\nThe SCIM Group externalId parameter maps to the Sys Scim Group \\[sys\\_scim\\_group\\] table.\n\n|SCIM attribute name|Sys Scim Group field name|\n|-------------------|-------------------------|\n|externalId|external\\_id|\n\nThe SCIM Group ServiceNow extension schema \\(urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group\\) maps to the Group \\[sys\\_user\\_group\\] table.\n\n|SCIM attribute name|Group field name|\n|-------------------|----------------|\n|company.value|company.sys\\_id|\n|company.name|company.name|\n\nThe SCIM Company resource schema \\(urn:ietf:params:scim:schemas:custom:servicenow:2.0:Company\\) maps to the Company \\[core\\_company\\] table.\n\n|SCIM attribute name|Company field name|\n|-------------------|------------------|\n|id|sys\\_id|\n|meta.created|sys\\_created\\_on|\n|meta.lastModified|sys\\_updated\\_on|\n|name|name|\n\nThe SCIM CostCenter resource schema \\(urn:ietf:params:scim:schemas:custom:servicenow:2.0:CostCenter\\) maps to the Cost Center \\[cmn\\_cost\\_center\\] table.\n\n|SCIM attribute name|Cost Center field name|\n|-------------------|----------------------|\n|id|sys\\_id|\n|meta.created|sys\\_created\\_on|\n|meta.lastModified|sys\\_updated\\_on|\n|name|name|\n\nThe SCIM Department resource schema \\(urn:ietf:params:scim:schemas:custom:servicenow:2.0:Department\\) maps to the Department \\[cmn\\_department\\] table.\n\n|SCIM attribute name|Department field name|\n|-------------------|---------------------|\n|id|sys\\_id|\n|meta.created|sys\\_created\\_on|\n|meta.lastModified|sys\\_updated\\_on|\n|name|name|\n\nThe SCIM Location resource schema \\(urn:ietf:params:scim:schemas:custom:servicenow:2.0:Location\\) maps to the Location \\[cmn\\_location\\] table.\n\n|SCIM attribute name|Location field name|\n|-------------------|-------------------|\n|id|sys\\_id|\n|meta.created|sys\\_created\\_on|\n|meta.lastModified|sys\\_updated\\_on|\n|name|name|\n\n## SCIM-specific tables\n\nTwo tables, Sys Scim User \\[sys\\_scim\\_user\\] and Sys Scim Group \\[sys\\_scim\\_group\\], contain the SCIM attributes that do not map to existing ServiceNow tables. The following define the contents of these tables.\n\n<table id=\"table_w2h_nch_mrb\"><thead><tr><th>\n\nField name\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nCreated\n\n</td><td>\n\nDate and time that the associated record was created.Data type: String\n\n Maximum length: 40\n\n</td></tr><tr><td>\n\nCreated by\n\n</td><td>\n\nName of the entity that created the record.Data type: String\n\n Maximum length: 40\n\n</td></tr><tr><td>\n\nExternal ID\n\n</td><td>\n\nExternal ID used by the entity that created this user record to reference the user in their system.Data type: String\n\n Maximum length: 255\n\n</td></tr><tr><td>\n\nSys ID\n\n</td><td>\n\nUnique identifier for the record within a ServiceNow instance.Data type: String\n\n Maximum length: 32\n\n</td></tr><tr><td>\n\nUpdated\n\n</td><td>\n\nDate and time that the associated record was last updated.Data type: String\n\n Maximum length: 40\n\n</td></tr><tr><td>\n\nUpdated by\n\n</td><td>\n\nName of the entity that last updated the associated record.Data type: String\n\n Maximum length: 40\n\n</td></tr><tr><td>\n\nUpdates\n\n</td><td>\n\nNumber of times that the record has been updated.Data type: Number \\(Integer\\)\n\nMaximum length: 40\n\n</td></tr><tr><td>\n\nUser\n\n</td><td>\n\nReference to the user associated with this recordReference: User \\[sys\\_user\\] table\n\nMaximum length: 32\n\n</td></tr><tr><td>\n\nUser type\n\n</td><td>\n\nType of user record. This value is used to identify the organization to user relationship.This can be any value, but typical values might include:\n\n-   Contractor\n-   Employee\n-   External\n-   Intern\n-   Temp\n-   Unknown\n\n Data type: String\n\n Maximum length: 40\n\n</td></tr></tbody>\n</table><table id=\"table_mpt_nch_mrb\"><thead><tr><th>\n\nField name\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nCreated\n\n</td><td>\n\nDate and time that the associated record was created.Data type: String\n\n Maximum length: 40\n\n</td></tr><tr><td>\n\nCreated by\n\n</td><td>\n\nName of the entity that created the record.Data type: String\n\n Maximum length: 40\n\n</td></tr><tr><td>\n\nExternal ID\n\n</td><td>\n\nExternal ID used by the entity that created this group record to reference the group in their system.Data type: String\n\n Maximum length: 255\n\n</td></tr><tr><td>\n\nGroup\n\n</td><td>\n\nReference to the group associated with this record.Reference: Group \\[sys\\_user\\_group\\] table\n\n Maximum length: 32\n\n</td></tr><tr><td>\n\nSys ID\n\n</td><td>\n\nUnique identifier for the record within a ServiceNow instance.Data type: String\n\n Maximum length: 32\n\n</td></tr><tr><td>\n\nUpdated\n\n</td><td>\n\nDate and time that the associated record was last updated.Data type: String\n\n Maximum length: 40\n\n</td></tr><tr><td>\n\nUpdated by\n\n</td><td>\n\nName of the entity that last updated the associated record.Data type: String\n\n Maximum length: 40\n\n</td></tr><tr><td>\n\nUpdates\n\n</td><td>\n\nNumber of times that the record has been updated.Data type: Number \\(Integer\\)\n\nMaximum length: 40\n\n</td></tr></tbody>\n</table>## Roles and access control lists\n\nThe scim\\_admin role is required to access the SCIM-specific tables and the private SCIM endpoints and enables access to the User \\[sys\\_user\\] and Group \\[sys\\_user\\_group\\] tables.\n\nThe SCIM service has four ACLs for accessing the Sys Scim User \\[sys\\_scim\\_user\\] table and the Sys Scim Group \\[sys\\_scim\\_group\\] table that enable create, delete, read, and write. These ACLs are only mapped to the scim\\_admin role.\n\n**Parent Topic:**[REST API reference](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-apis/api-rest.md)\n\n## SCIM - DELETE /scim/Groups/\\{group\\_id\\}\n\nDeletes the specified group record from the Group \\[sys\\_user\\_group\\] table of a ServiceNow instance using the System for Cross-domain Identity Management \\(SCIM\\) protocol.\n\n### URL format\n\nVersioned URL: `/api/now/{api_version}/scim/Groups/{group_id}`\n\nDefault URL: `/api/now/scim/Groups/{group_id}`\n\n**Note:** Available versions are specified in the [REST API Explorer](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/use-REST-API-Explorer.md). For scripted REST APIs there is additional version information on the [Scripted REST Service form](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_CustomWebServices.md).\n\n### Supported request parameters\n\n<table class=\"rest_api_path_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\napi\\_version\n\n</td><td id=\"version-entry-RESTAPI\">\n\nOptional. Version of the endpoint to access. For example, `v1` or `v2`. Only specify this value to use an endpoint version other than the latest. Data type: String\n\n</td></tr><tr><td>\n\ngroup\\_id\n\n</td><td>\n\nSys\\_id of the group record to delete. Data type: String\n\nTable: Group \\[sys\\_user\\_group\\]\n\n</td></tr></tbody>\n</table>|Name|Description|\n|----|-----------|\n|None| |\n\n|Name|Description|\n|----|-----------|\n|None| |\n\n### Headers\n\nThe following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table class=\"rest_api_request_headers\"><thead><tr><th>\n\nHeader\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nAccept\n\n</td><td id=\"Accept-SCIM-entry\">\n\nData format of the response body. Supported types: **application/json** or **application/scim+json**.Default: **application/json**\n\n</td></tr></tbody>\n</table>|Header|Description|\n|------|-----------|\n|None| |\n\n### Status codes\n\nThe following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n|Status code|Description|\n|-----------|-----------|\n|204|No Content. The request was successfully processed.|\n|404|Not found. The requested item wasn't found.|\n\n### Response body parameters \\(JSON\\)\n\n<table><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nerrors\n\n</td><td id=\"errors-SCIM-entry\">\n\nResponse that describes any errors that may have occurred during processing the request.Data type: Object\n\n```\n\"errors\": {\n  \"details\": \"String\",\n  \"schemas\": \"String\",\n  \"scimType\": \"String\",\n  \"status\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nerrors.detail\n\n</td><td id=\"errors_details-SCIM-entry\">\n\nDetailed error message on why the request failed.Data type: String\n\n</td></tr><tr><td>\n\nerrors.scimType\n\n</td><td id=\"errors_scimType-SCIM-entry\">\n\nSCIM error detail keyword.Data type: String\n\n</td></tr><tr><td>\n\nerrors.schemas\n\n</td><td id=\"errors_schemas-SCIM-entry\">\n\nURI of the SCIM Schemas used to process the error response.Data type: Array of Strings\n\n</td></tr><tr><td>\n\nerrors.status\n\n</td><td id=\"errors_status-SCIM-entry\">\n\nHTTP status code for the error response.Data type: String\n\n</td></tr></tbody>\n</table>### cURL request to delete a group\n\nThis example shows how to delete a group record from the Group \\[sys\\_user\\_group\\] table.\n\n```\ncurl \"https://instance-servicenow.com/api/now/scim/Groups/a0a9e9fb1b7e3010593876a61a4bcbe0\" \\\n--request DELETE \\\n--header \"Accept:application/scim+json\" \\\n```\n\n## SCIM - GET /scim/Groups\n\nReturns one or more group records from the Group \\[sys\\_user\\_group\\] table within a ServiceNow instance using the System for Cross-domain Identity Management \\(SCIM\\) protocol.\n\n**Note:** A query that does not return any matches returns success \\(HTTP status code 200\\) with **totalResults** set to 0.\n\n### URL format\n\nVersioned URL: `/api/now/{api_version}/scim/Groups`\n\nDefault URL: `/api/now/scim/Groups`\n\n**Note:** Available versions are specified in the [REST API Explorer](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/use-REST-API-Explorer.md). For scripted REST APIs there is additional version information on the [Scripted REST Service form](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_CustomWebServices.md).\n\n### Supported request parameters\n\n<table class=\"rest_api_path_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\napi\\_version\n\n</td><td id=\"version-entry-RESTAPI\">\n\nOptional. Version of the endpoint to access. For example, `v1` or `v2`. Only specify this value to use an endpoint version other than the latest. Data type: String\n\n</td></tr></tbody>\n</table><table class=\"rest_api_query_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nattributes\n\n</td><td id=\"attributes-SCIM-entry\">\n\nComma-separated list of fields to return in the response. No other fields are returned.Can't be used with the **excludedAttributes** parameter.\n\nData type: String\n\nDefault: Return all fields unless **excludedAttributes** is specified.\n\n</td></tr><tr><td>\n\ncount\n\n</td><td id=\"count-SCIM-entry\">\n\nNumber of records to return. A negative value is interpreted as zero.Data type: Number\n\nMaximum: 500 - A value greater than this results in a bad request error.\n\nDefault: 10\n\n</td></tr><tr><td>\n\nexcludedAttributes\n\n</td><td id=\"excludedAttributes-SCIM-entry\">\n\nComma-separated list of fields to exclude from the records returned in the response. All other fields are returned.Can't be used with the **attributes** parameter.\n\nData type: String\n\nDefault: Do not exclude any fields.\n\n</td></tr><tr><td>\n\nfilter\n\n</td><td id=\"group_filter-SCIM-entry\">\n\nFilter expression to apply to the return results. Field filters are expressed as `<field_name> <operator> <\"value\">`. Refer to [RFC7644](https://datatracker.ietf.org/doc/html/rfc7644#section-3.4.2) for a list of the valid operators. **Note:** The `NOT` operator is not supported by this method.\n\nFor example, to filter for all groups whose name starts with \"HR\", enter `displayName SW \"HR\"`.\n\nTo specify more than one field filter, concatenate the filters using the `AND` operand. For example, to filter for all groups whose name starts with \"HR\" and were last modified before October 3, 2021, enter `displayName SW \"HR\" AND meta.lastModified lt \"2021-10-33T00:00:00Z\"`. Use dot-walking to specify nested attributes.\n\nOnly the following SCIM group fields are available for use in filters:\n\n-   displayName\n-   externalId: Only supports `EQ` operator.\n-   id\n-   meta.created\n-   meta.lastModified\n\nData type: String\n\nDefault: No filtering\n\n</td></tr><tr><td>\n\nsortBy\n\n</td><td id=\"group_sortBy-SCIM-entry\">\n\nMust be specified with the **sortOrder** parameter. Field by which to sort the return results. Sorting is case-insensitive. You can only use those parameters available for filtering for the **sortBy** parameter, except that **externalId** is not allowed.\n\nFor values that are null:\n\n-   sorted by ascending: Null values are sorted to the top.\n-   sorted by descending: Null values are sorted to the bottom.\n\nData type: String\n\nDefault: No sort\n\n</td></tr><tr><td>\n\nsortOrder\n\n</td><td id=\"sortOrder-SCIM-entry\">\n\nMust be specified with the **sortBy** parameter. Order in which the **sortBy** parameter is applied to the return results. Valid values:\n\n-   ascending\n-   descending\n\nData type: String\n\nDefault: ascending\n\n</td></tr><tr><td>\n\nstartIndex\n\n</td><td id=\"group_startIndex-SCIM-entry\">\n\nOne-based index into the table at which to start retrieving records. For example, if you set this parameter to 100, and the **count** parameter to 20, the endpoint returns records 100 through 119. **Note:** Any value that is set to less than one is interpreted as one.\n\nData type: String\n\nDefault: 1\n\n</td></tr></tbody>\n</table>|Name|Description|\n|----|-----------|\n|None| |\n\n### Headers\n\nThe following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table class=\"rest_api_request_headers\"><thead><tr><th>\n\nHeader\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nAccept\n\n</td><td id=\"Accept-SCIM-entry\">\n\nData format of the response body. Supported types: **application/json** or **application/scim+json**.Default: **application/json**\n\n</td></tr></tbody>\n</table>|Header|Description|\n|------|-----------|\n|None| |\n\n### Status codes\n\nThe following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table><thead><tr><th>\n\nStatus code\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\n200\n\n</td><td id=\"entry-200-status-code\">\n\nSuccessful. The request was successfully processed.\n\n</td></tr><tr><td>\n\n400\n\n</td><td id=\"status_400-SCIM-entry\">\n\nBad Request. A bad request type or malformed request was detected.-   Ensure that both the **attributes** and **excludedAttributes** query parameters have not been passed in the request.\n-   Ensure that the **count** parameter is not greater than 500.\n-   Ensure that all **filter** parameters are valid.\n\n</td></tr><tr><td>\n\n401\n\n</td><td id=\"entry-401-status-code\">\n\nUnauthorized. The user credentials are incorrect or have not been passed.\n\n</td></tr></tbody>\n</table>### Response body parameters \\(JSON\\)\n\n<table><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nitemsPerPage\n\n</td><td id=\"itemsPerPage-SCIM-entry\">\n\nNumber of records returned in the return results.Data type: Number\n\n</td></tr><tr><td>\n\nResources\n\n</td><td>\n\nList of group records.Data type: Array of Objects\n\n ```\n\"Resources\": [\n  {\n    \"company\": {Object},\n    \"displayName\": \"String\",\n    \"externalId\": \"String\",\n    \"id\": \"String\",\n    \"meta\": [Array]\n  }\n]\n```\n\n</td></tr><tr><td>\n\nResources.company\n\n</td><td>\n\nDetails about the group's company or organization.Data type: Object\n\n ```\n\"company\": {\n  \"display\": \"String\",\n  \"$ref\": \"String\",\n  \"value\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nResources.company.display\n\n</td><td>\n\nName of the company.Data type: String\n\n</td></tr><tr><td>\n\nResources.company.$ref\n\n</td><td>\n\nReference URI of the company.Format: `<host>/Companies/<company sys_id>`, such as: `http://instance-servicenow.com/api/now/scim/Companies/81fd65ecac1d55eb42a426568fc87a63`.\n\nData type: String\n\n</td></tr><tr><td>\n\nResources.company.value\n\n</td><td>\n\nSys\\_id of the associated company.Data type: String\n\n</td></tr><tr><td>\n\nResources.displayName\n\n</td><td>\n\nHuman-readable name of the group, such as HR Team.Data type: String\n\n</td></tr><tr><td>\n\nResources.externalId\n\n</td><td>\n\nUnique identifier assigned to the group by the entity provisioning it.Data type: String\n\n</td></tr><tr><td>\n\nResources.id\n\n</td><td>\n\nSys\\_id of the group.Data type: String\n\n</td></tr><tr><td>\n\nResources.meta\n\n</td><td>\n\nMetadata pertaining to the group.Data type: Object\n\n```\n\"meta\": {\n  \"created\": \"String\",\n  \"lastModified\": \"String\",\n  \"location\": String\",\n  \"resourceType\": String\"\n}\n```\n\n</td></tr><tr><td>\n\nResources.meta.created\n\n</td><td>\n\nDate and time when the group record was created.Data type: String\n\n</td></tr><tr><td>\n\nResources.meta.lastModified\n\n</td><td>\n\nDate and time when the group record was last modified.Data type: String\n\n</td></tr><tr><td>\n\nResources.meta.location\n\n</td><td>\n\nURI of the group being retrieved.Data type: String\n\n</td></tr><tr><td>\n\nResources.meta.resourceType\n\n</td><td>\n\nSCIM Groups' resource type.Data type: String\n\n</td></tr><tr><td>\n\nResources.members\n\n</td><td>\n\nList of the users and groups associated with the group.Data type: Array of Objects\n\n```\n\"members\": [\n  {\n    \"display\": \"String\",\n    \"value\": \"String\",\n    \"$ref\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nResources.members.display\n\n</td><td>\n\nName of the associated group member.Data type: String\n\n</td></tr><tr><td>\n\nResources.members.value\n\n</td><td>\n\nSys\\_id of the associated user or group record.Data type: String\n\n</td></tr><tr><td>\n\nResources.members.$ref\n\n</td><td>\n\nURI of the associated group member.Data type: String\n\n</td></tr><tr><td>\n\nResources.schemas\n\n</td><td>\n\nList of URIs of the SCIM Group schemas used to process the request.\n\nSupported group schemas:\n\n-   urn:ietf:params:scim:schemas:core:2.0:Group - Core schema specified in the Internet Engineering Task Force System for Cross-domain Identity Management: Core Schema document \\([https://datatracker.ietf.org/doc/html/rfc7643\\#section-4.2](https://datatracker.ietf.org/doc/html/rfc7643#section-4.2)\\)\n-   urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group - ServiceNow extension schema. This schema contains attributes that are present in the Groups \\[sys\\_user\\_group\\] table in a base ServiceNow system, but are not part of the core schema.\n-   urn:ietf:params:scim:schemas:extension:servicenow:custom:2.0:Group” - Custom extension schema. This schema is part of “Group” resourceType in the sys\\_scim\\_schema\\_extension table. If the schema is not active, the schema URN is not returned in the response.\n\nData type: Array of Strings\n\n</td></tr><tr><td>\n\nschemas\n\n</td><td>\n\nList of URIs of the SCIM List Response schemas used to process the request.Data type: Array\n\n</td></tr><tr><td>\n\nstartIndex\n\n</td><td>\n\nOne-based index into the Group \\[sys\\_user\\_group\\] table at which the endpoint started retrieving records.Data type: Number\n\n</td></tr><tr><td>\n\ntotalResults\n\n</td><td id=\"totalResults-SCIM-entry\">\n\nTotal number of records that match the request.Data type: Number\n\n</td></tr></tbody>\n</table>### cURL request for multiple groups\n\nThis example shows how to request multiple groups \\(four in this case\\), using the **count** parameter.\n\n```\ncurl \"https://instance-sevicenow.com/api/now/scim/Groups?count=4\" \\\n--request GET \\\n--header \"Accept:application/scim+json\" \\\n```\n\nResponse:\n\n```\n{\"schemas\":\n  [\"urn:ietf:params:scim:api:messages:2.0:ListResponse\"],\n  \"totalResults\":44,\n  \"Resources\":[\n    {\"schemas\":\n      [\n        \"urn:ietf:params:scim:schemas:core:2.0:Group\"\",\n        “urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group”,\n        “urn:ietf:params:scim:schemas:extension:servicenow:custom:2.0:Group”\n      ],\n      \"id\":\"019ad92ec7230010393d265c95c260dd\",\n      \"meta\":{\n        \"resourceType\":\"Group\",\n        \"created\":\"2020-03-17T11:39:14Z\",\n        \"lastModified\":\"2020-03-17T11:39:14Z\",\n        \"location\":\"https://instance-sevicenow.com/api/now/scim/Groups/019ad92ec7230010393d265c95c260dd\"\n      },\n      \"displayName\":\"Analytics Settings Managers\"\n    },\n    {\"schemas\":\n      [\n        \"urn:ietf:params:scim:schemas:core:2.0:Group\"\",\n        “urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group”,\n        “urn:ietf:params:scim:schemas:extension:servicenow:custom:2.0:Group”\n      ],\n      \"id\":\"0a52d3dcd7011200f2d224837e6103f2\",\n      \"meta\":{\n        \"resourceType\":\"Group\",\n        \"created\":\"2021-09-29T16:42:02Z\",\n        \"lastModified\":\"2021-09-29T16:42:02Z\",\n        \"location\":\"https://instance-sevicenow.com/api/now/scim/Groups/0a52d3dcd7011200f2d224837e6103f2\"\n      },\n      \"displayName\":\"Application Development\",\n      \"members\":[\n        {\n          \"value\":\"dc6053dcd7011200f2d224837e6103e0\",\n          \"display\":\"John Doe\",\n          \"$ref\": \"http://instance-sevicenow.com/api/now/scim/Users/dc6053dcd7011200f2d224837e6103e0\"\n        },\n        {\n          \"value\":\"443193dcd7011200f2d224837e61037d\",\n          \"display\":\"Abel Tutor\",\n          \"$ref\": \"http://instance-sevicenow.com/api/now/scim/Users/443193dcd7011200f2d224837e61037d\"\n        }\n      ],\n      \"urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group\": {\n        \"company\": {\n          \"value\": \"81fd65ecac1d55eb42a426568fc87a63\",\n          \"name\": \"ACME Japan\",\n          \"$ref\": \"http://instance-sevicenow.com/api/now/scim/Companies/81fd65ecac1d55eb42a426568fc87a63\"\n        }\n      }\n    },\n    {\"schemas\":\n      [\n        \"urn:ietf:params:scim:schemas:core:2.0:Group\"\",\n        “urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group”,\n        “urn:ietf:params:scim:schemas:extension:servicenow:custom:2.0:Group”\n      ],\n      \"id\":\"0c4e7b573b331300ad3cc9bb34efc461\",\n      \"meta\":{\n        \"resourceType\":\"Group\",\n        \"created\":\"2021-09-29T05:11:33Z\",\n        \"lastModified\":\"2021-09-29T05:11:33Z\",\n        \"location\":\"instance-sevicenow.com/api/now/scim/Groups/0c4e7b573b331300ad3cc9bb34efc461\"\n      },\n      \"displayName\":\"Problem Analyzers\",\n      \"members\":[\n        {\n          \"value\":\"d3dbbf173b331300ad3cc9bb34efc466\",\n          \"display\":\"Problem Manager\",\n          \"$ref\": \"http://instance-sevicenow.com/api/now/scim/Users/babb4639b76233004fbc2089ee11a97f\"\n        },\n        {\n          \"value\":\"38cb3f173b331300ad3cc9bb34efc4d6\",\n          \"display\":\"Problem Coordinator B\",\n          \"$ref\": \"http://instance-sevicenow.com/api/now/scim/Users/cbcc4639b76233004fbc2089ee111047\"\n        },\n        {\n          \"value\":\"26fbff173b331300ad3cc9bb34efc4bd\",\n          \"display\":\"Problem Administrator\",\n          \"$ref\": \"http://instance-sevicenow.com/api/now/scim/Users/45324639b76232189fbc2089ee11bc34\"\n        }\n      ],\n      \"urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group\": {\n        \"company\": {\n          \"value\": \"913465ecac1d569b42a426568fc88af3\",\n          \"name\": \"ACME London\",\n          \"$ref\": \"http://instance-sevicenow.com/api/now/scim/Companies/913465ecac1d569b42a426568fc88af3\"\n        }\n      }\n    },\n    {\"schemas\":\n      [\n        \"urn:ietf:params:scim:schemas:core:2.0:Group\"\",\n        \"urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group\",\n        \"urn:ietf:params:scim:schemas:extension:servicenow:custom:2.0:Group\"\n      ],\n      \"id\":\"0c5e2a7ce4001410f877ce457cda6b98\",\n      \"meta\":{\n        \"resourceType\":\"Group\",\n        \"created\":\"2020-04-06T03:47:08Z\",\n        \"lastModified\":\"2020-07-29T04:02:26Z\",\n        \"location\":\"instance-sevicenow.com/api/now/scim/Groups/0c5e2a7ce4001410f877ce457cda6b98\"\n      },\n      \"displayName\":\"Business Application Registration Approval Group\"\n    }\n  ],\n  \"startIndex\":1,\n  \"itemsPerPage\":4\n}\n```\n\n### cURL request for multiple groups using excludedAttributes\n\nThis example shows how to request multiple groups \\(four in this case\\), using the **count** parameter and excluding the meta and members fields.\n\n```\ncurl \"https://instance-sevicenow.com/api/now/scim/Groups?excludedAttributes=meta%2C%20members&count=4\" \\\n--request GET \\\n--header \"Accept:application/scim+json\" \\\n```\n\nResponse:\n\n```\n{\"schemas\":\n  [\"urn:ietf:params:scim:api:messages:2.0:ListResponse\"],\n  \"totalResults\":44,\n  \"Resources\":[\n    {\"schemas\":\n      [\n        \"urn:ietf:params:scim:schemas:core:2.0:Group\"\",\n        “urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group”,\n        “urn:ietf:params:scim:schemas:extension:servicenow:custom:2.0:Group”\n      ],\n      \"id\":\"019ad92ec7230010393d265c95c260dd\",\n      \"displayName\":\"Analytics Settings Managers\",\n      \"urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group\": {\n        \"company\": {\n          \"value\": \"913465ecac1d569b42a426568fc88af3\",\n          \"name\": \"ACME London\",\n          \"$ref\": \"http://instance-sevicenow.com/api/now/scim/Companies/913465ecac1d569b42a426568fc88af3\"\n        }\n      }\n    },\n    {\"schemas\":\n      [\n        \"urn:ietf:params:scim:schemas:core:2.0:Group\"\",\n        “urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group”,\n        “urn:ietf:params:scim:schemas:extension:servicenow:custom:2.0:Group”\n      ],\n      \"id\":\"0a52d3dcd7011200f2d224837e6103f2\",\n      \"displayName\":\"Application Development\"\n    },\n    {\"schemas\":\n      [\n        \"urn:ietf:params:scim:schemas:core:2.0:Group\"\",\n        “urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group”,\n        “urn:ietf:params:scim:schemas:extension:servicenow:custom:2.0:Group”\n      ],\n      \"id\":\"0c4e7b573b331300ad3cc9bb34efc461\",\n      \"displayName\":\"Problem Analyzers\"\n    },\n    {\"schemas\":\n      [\n        \"urn:ietf:params:scim:schemas:core:2.0:Group\"\",\n        “urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group”,\n        “urn:ietf:params:scim:schemas:extension:servicenow:custom:2.0:Group”\n      ],\n      \"id\":\"0c5e2a7ce4001410f877ce457cda6b98\",\n      \"displayName\":\"Business Application Registration Approval Group\",\n      \"urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group\": {\n        \"company\": {\n          \"value\": \"81fd65ecac1d55eb42a426568fc87a63\",\n          \"name\": \"ACME Japan\",\n          \"$ref\": \"http://instance-sevicenow.com/api/now/scim/Companies/81fd65ecac1d55eb42a426568fc87a63\"\n        }\n      }\n    }\n  ],\n  \"startIndex\":1,\n  \"itemsPerPage\":4\n}\n```\n\n## SCIM - GET /scim/Groups/\\{group\\_id\\}\n\nReturns the specified group record from the Group \\[sys\\_user\\_group\\] table within a ServiceNow instance using the System for Cross-domain Identity Management \\(SCIM\\) protocol.\n\n### URL format\n\nVersioned URL: `/api/now/{api_version}/scim/Groups/{group_id}`\n\nDefault URL: `/api/now/scim/Groups/{group_id}`\n\n**Note:** Available versions are specified in the [REST API Explorer](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/use-REST-API-Explorer.md). For scripted REST APIs there is additional version information on the [Scripted REST Service form](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_CustomWebServices.md).\n\n### Supported request parameters\n\n<table class=\"rest_api_path_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\napi\\_version\n\n</td><td id=\"version-entry-RESTAPI\">\n\nOptional. Version of the endpoint to access. For example, `v1` or `v2`. Only specify this value to use an endpoint version other than the latest. Data type: String\n\n</td></tr><tr><td>\n\ngroup\\_id\n\n</td><td>\n\nSys\\_id of the group record to return.\n\n</td></tr></tbody>\n</table><table class=\"rest_api_query_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nattributes\n\n</td><td id=\"attributes-SCIM-entry\">\n\nComma-separated list of fields to return in the response. No other fields are returned.Can't be used with the **excludedAttributes** parameter.\n\nData type: String\n\nDefault: Return all fields unless **excludedAttributes** is specified.\n\n</td></tr><tr><td>\n\nexcludedAttributes\n\n</td><td id=\"excludedAttributes-SCIM-entry\">\n\nComma-separated list of fields to exclude from the records returned in the response. All other fields are returned.Can't be used with the **attributes** parameter.\n\nData type: String\n\nDefault: Do not exclude any fields.\n\n</td></tr></tbody>\n</table>|Name|Description|\n|----|-----------|\n|None| |\n\n### Headers\n\nThe following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table class=\"rest_api_request_headers\"><thead><tr><th>\n\nHeader\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nAccept\n\n</td><td id=\"Accept-SCIM-entry\">\n\nData format of the response body. Supported types: **application/json** or **application/scim+json**.Default: **application/json**\n\n</td></tr></tbody>\n</table>|Header|Description|\n|------|-----------|\n|None| |\n\n### Status codes\n\nThe following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table><thead><tr><th>\n\nStatus code\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\n200\n\n</td><td id=\"entry-200-status-code\">\n\nSuccessful. The request was successfully processed.\n\n</td></tr><tr><td>\n\n400\n\n</td><td id=\"status_400-SCIM-entry\">\n\nBad Request. A bad request type or malformed request was detected.-   Ensure that both the **attributes** and **excludedAttributes** query parameters have not been passed in the request.\n-   Ensure that the **count** parameter is not greater than 500.\n-   Ensure that all **filter** parameters are valid.\n\n</td></tr><tr><td>\n\n404\n\n</td><td id=\"entry-404-status-code\">\n\nNot found. The requested item wasn't found.\n\n</td></tr></tbody>\n</table>### Response body parameters \\(JSON\\)\n\n<table id=\"id_uwk_c5c_grb\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr id=\"group_company-SCIM-row\"><td>\n\ncompany\n\n</td><td id=\"group_company-SCIM-entry\">\n\nDetails about the group's company or organization.Data type: Object\n\n```\n\"company\": {\n  \"display\": \"String\",\n  \"$ref\": \"String\",\n  \"value\": \"String\"\n}\n```\n\n</td></tr><tr id=\"group_company_display-SCIM-row\"><td>\n\ncompany.display\n\n</td><td id=\"group_company_display-SCIM-entry\">\n\nName of the company.Data type: String\n\n</td></tr><tr id=\"group_company_ref-SCIM-row\"><td>\n\ncompany.$ref\n\n</td><td id=\"group_company_ref-SCIM-entry\">\n\nReference URI of the company.Format: `<host>/Companies/<company sys_id>`, such as: `http://instance-servicenow.com/api/now/scim/Companies/81fd65ecac1d55eb42a426568fc87a63`.\n\nData type: String\n\n</td></tr><tr id=\"group_company_value-SCIM-row\"><td>\n\ncompany.value\n\n</td><td id=\"group_company_value-SCIM-entry\">\n\nSys\\_id of the associated company.Data type: String\n\n</td></tr><tr id=\"group_displayName-SCIM-row\"><td>\n\ndisplayName\n\n</td><td id=\"group_displayName-SCIM-entry\">\n\nHuman-readable name of the group, such as HR Team.Data type: String\n\n</td></tr><tr id=\"group_externalId-SCIM-row\"><td>\n\nexternalId\n\n</td><td id=\"group_externalId-SCIM-entry\">\n\nUnique identifier assigned to the group by the entity provisioning it.Data type: String\n\n</td></tr><tr id=\"group_id-SCIM-row\"><td>\n\nid\n\n</td><td id=\"group_id-SCIM-entry\">\n\nSys\\_id of the group.Data type: String\n\n</td></tr><tr id=\"group_meta-SCIM-row\"><td>\n\nmeta\n\n</td><td id=\"group_meta-SCIM-entry\">\n\nMetadata pertaining to the group.Data type: Object\n\n```\n\"meta\": {\n  \"created\": \"String\",\n  \"lastModified\": \"String\",\n  \"location\": String\",\n  \"resourceType\": String\"\n}\n```\n\n</td></tr><tr id=\"group_meta_created-SCIM-row\"><td>\n\nmeta.created\n\n</td><td id=\"group_meta_created-SCIM-entry\">\n\nDate and time when the group record was created.Data type: String\n\n</td></tr><tr id=\"group_meta_lastModified-SCIM-row\"><td>\n\nmeta.lastModified\n\n</td><td id=\"group_meta_lastModified-SCIM-entry\">\n\nDate and time when the group record was last modified.Data type: String\n\n</td></tr><tr id=\"group_meta_location-SCIM-row\"><td>\n\nmeta.location\n\n</td><td id=\"group_meta_location-SCIM-entry\">\n\nURI of the group being retrieved.Data type: String\n\n</td></tr><tr id=\"group_meta_resourceType-SCIM-row\"><td>\n\nmeta.resourceType\n\n</td><td id=\"group_meta_resourceType-SCIM-entry\">\n\nSCIM Groups' resource type.Data type: String\n\n</td></tr><tr id=\"group_members-SCIM-row\"><td>\n\nmembers\n\n</td><td id=\"group_members-SCIM-entry\">\n\nList of the users and groups associated with the group.Data type: Array of Objects\n\n```\n\"members\": [\n  {\n    \"display\": \"String\",\n    \"value\": \"String\",\n    \"$ref\": \"String\"\n  }\n]\n```\n\n</td></tr><tr id=\"group_members_display-SCIM-row\"><td>\n\nmembers.display\n\n</td><td id=\"group_members_display-SCIM-entry\">\n\nName of the associated group member.Data type: String\n\n</td></tr><tr id=\"group_members_value-SCIM-row\"><td>\n\nmembers.value\n\n</td><td id=\"group_members_value-SCIM-entry\">\n\nSys\\_id of the associated user or group record.Data type: String\n\n</td></tr><tr id=\"group_members_ref-SCIM-row\"><td>\n\nmembers.$ref\n\n</td><td id=\"group_members_ref-SCIM-entry\">\n\nURI of the associated group member.Data type: String\n\n</td></tr><tr id=\"group_schemas-SCIM-row\"><td>\n\nschemas\n\n</td><td id=\"group_schemas-SCIM-entry\">\n\nList of URIs of the SCIM Group schemas used to process the request.\n\nSupported group schemas:\n\n-   urn:ietf:params:scim:schemas:core:2.0:Group - Core schema specified in the Internet Engineering Task Force System for Cross-domain Identity Management: Core Schema document \\([https://datatracker.ietf.org/doc/html/rfc7643\\#section-4.2](https://datatracker.ietf.org/doc/html/rfc7643#section-4.2)\\)\n-   urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group - ServiceNow extension schema. This schema contains attributes that are present in the Groups \\[sys\\_user\\_group\\] table in a base ServiceNow system, but are not part of the core schema.\n-   urn:ietf:params:scim:schemas:extension:servicenow:custom:2.0:Group” - Custom extension schema. This schema is part of “Group” resourceType in the sys\\_scim\\_schema\\_extension table. If the schema is not active, the schema URN is not returned in the response.\n\nData type: Array of Strings\n\n</td></tr></tbody>\n</table>### cURL request for specific group\n\nThis example shows how to retrieve a specific group record.\n\n```\ncurl \"https://instance-servicenow.com/api/now/scim/Groups/e0140d671bbe3010593876a61a4bcb11\" \\\n--request GET \\\n--header \"Accept:application/scim+json\" \\\n```\n\nResponse:\n\n```\n{\"schemas\":\n  [\n    \"urn:ietf:params:scim:schemas:core:2.0:Group\",\n    \"urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group\",\n    \"urn:ietf:params:scim:schemas:extension:servicenow:custom:2.0:Group\"\n  ],\n  \"id\":\"e0140d671bbe3010593876a61a4bcb11\",\n  \"externalId\":\"8ae5dc9e-c7ad-4d3d-a152-35a6b6222b83\",\n  \"meta\":{\n    \"resourceType\":\"Group\",\n    \"created\":\"2021-09-30T18:20:43Z\",\n    \"lastModified\":\"2021-09-30T18:20:43Z\",\n    \"location\":\"https://instance-servicenow.com/api/now/scim/Groups/e0140d671bbe3010593876a61a4bcb11\"},\n    \"displayName\":\"HR Group\",\n    \"members\":[\n      {\n        \"value\":\"62826bf03710200044e0bfc8bcbe5df1\",\n        \"display\":\"Abel Tuter\",\n        \"$ref\": \"http://instance-servicenow.com/api/now/scim/Users/62826bf03710200044e0bfc8bcbe5df1\"\n      }\n    ], \n    \"urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group\": {\n      \"company\": {\n        \"value\": \"81fd65ecac1d55eb42a426568fc87a63\",\n        \"name\": \"ACME Japan\",\n        \"$ref\": \"http://111.111.1.11:8080/api/now/scim/Companies/81fd65ecac1d55eb42a426568fc87a63\"\n      }\n    }\n  }\n}\n```\n\n## SCIM - PATCH /scim/Groups/\\{group\\_id\\}\n\nEnables you to add, update, and delete specified fields in a group record in the Group \\[sys\\_user\\_group\\] table of a ServiceNow instance using the System for Cross-domain Identity Management \\(SCIM\\) protocol.\n\nFor additional information, refer to the [Modifying with PATCH](https://datatracker.ietf.org/doc/html/rfc7644#section-3.5.2) section of RFC 7644.\n\n### URL format\n\nVersioned URL: `/api/now/{api_version}/scim/Groups/{group_id}`\n\nDefault URL: `/api/now/scim/Groups/{group_id}`\n\n### Supported request parameters\n\n<table class=\"rest_api_path_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\napi\\_version\n\n</td><td id=\"version-entry-RESTAPI\">\n\nOptional. Version of the endpoint to access. For example, `v1` or `v2`. Only specify this value to use an endpoint version other than the latest. Data type: String\n\n</td></tr><tr><td>\n\ngroup\\_id\n\n</td><td>\n\nSys\\_id of the group record to update.Data type: String\n\nTable: Group \\[sys\\_user\\_group\\]\n\n</td></tr></tbody>\n</table><table class=\"rest_api_query_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nattributes\n\n</td><td id=\"attributes-SCIM-entry\">\n\nComma-separated list of fields to return in the response. No other fields are returned.Can't be used with the **excludedAttributes** parameter.\n\nData type: String\n\nDefault: Return all fields unless **excludedAttributes** is specified.\n\n</td></tr><tr><td>\n\nexcludedAttributes\n\n</td><td id=\"excludedAttributes-SCIM-entry\">\n\nComma-separated list of fields to exclude from the records returned in the response. All other fields are returned.Can't be used with the **attributes** parameter.\n\nData type: String\n\nDefault: Do not exclude any fields.\n\n</td></tr></tbody>\n</table><table class=\"rest_api_request_body\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nOperations\n\n</td><td>\n\nRequired. List of operation objects to patch the specified Group record with.Data type: Array of Objects\n\n ```\n\"Operations\": [\n  {\n    \"op\": \"String\",\n    \"path\": \"String\",\n    \"value\": Any\n  }\n]\n```\n\n</td></tr><tr><td>\n\nOperations.op\n\n</td><td>\n\nRequired. Operation to perform.Valid values:\n\n-   add: Add the specified field and value to the Group record.\n-   remove: Remove the value from the specified field. Replaced with data type \"null\".\n-   replace: Replace the value of the specified field.\n\n Data type: String\n\n</td></tr><tr><td>\n\nOperations.path\n\n</td><td>\n\nRequired for `remove` operations, optional for others. Name/path of the field to modify.The **path** parameter can have one of the following formats:\n\n-   A direct field, such as `displayName`\n-   In case of complex array, a pointer to a specific element with a filter, such as: `emails[type eq \"work\"]`\n\n```\n{\n  \"schemas\": [\n    \"urn:ietf:params:scim:api:messages:2.0:PatchOp\"\n  ],\n  \"Operations\": [\n    {\n      \"op\": \"add\",\n      \"path\": \"displayName\",\n      \"value\": \"HR Group\"\n    },\n    {\n      \"op\": \"replace\", \n      \"path\": \"members[value eq \\\"sysid1\\\"]\", \n      \"value\": {\n        \"value\": \"sysid2\"\n      }\n    } \n  ]\n}\n```\n\n Data type: String\n\n Default: Considers the field to be a resource.\n\n</td></tr><tr><td>\n\nOperations.value\n\n</td><td>\n\nValue of the field specified in the **Operations.path** parameter. The format of this parameter depends on the data-type of the associated field. For example, if updating a simple string, such as the title, the **value** field is expressed as a string.\n\n ```\n \"Operations\": [\n  {\n    \"op\": \"add\",\n    \"path\": \"displayName\",\n    \"value\": \"HR Group\"\n  }\n]\n```\n\n You can also declare simple string values without a **path** parameters, such as:\n\n```\n \"Operations\": [\n  {\n    \"op\": \"add\",\n    \"value\": {\n      \"displayName\": \"HR Group\"\n    }\n  }\n]\n```\n\n The following shows how to add a member to the group:\n\n```\n{\n  \"op\": \"add\",\n  \"value\": {\n    \"members\": {\n      \"value\": \"62826bf03710200044e0bfc8bcbe5df1\",\n    }\n  }\n}\n```\n\n If the field being updated is not in the base-schema, you must enclose the name-value pair in an object that specifies the URN of the associated schema.\n\n ```\n\"value\": {\n  \"<schema_urn>\": {\n    \"<field_name>\": \"<new_value>\"\n  },\n}\n```\n\n For example:\n\n ```\n\"value\": {\n  \"urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group\": {\n    \"groupNumber\": \"13454\"\n  },\n}\n```\n\nData type: Any\n\n</td></tr><tr><td>\n\nOperations.value.type\n\n</td><td>\n\nName of the field to update.Data type: String\n\n</td></tr><tr><td>\n\nOperations.value.value\n\n</td><td>\n\nValue to update the field with. Data type: String\n\n</td></tr><tr><td>\n\nschemas\n\n</td><td id=\"group_schemas-SCIM-entry\">\n\nRequired. SCIM Schema URI of the Patch Operation: \"urn:ietf:params:scim:api:messages:2.0:PatchOp”Data type: String\n\n</td></tr></tbody>\n</table>### Headers\n\nThe following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table class=\"rest_api_request_headers\"><thead><tr><th>\n\nHeader\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nAccept\n\n</td><td id=\"Accept-SCIM-entry\">\n\nData format of the response body. Supported types: **application/json** or **application/scim+json**.Default: **application/json**\n\n</td></tr><tr><td>\n\nContent-Type\n\n</td><td id=\"Content_Type-SCIM-entry\">\n\nData format of the request body. Supported types: **application/json** or **application/scim+json**.Default: **application/json**\n\n</td></tr></tbody>\n</table>|Header|Description|\n|------|-----------|\n|None| |\n\n### Status codes\n\nThe following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table><thead><tr><th>\n\nStatus code\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\n200\n\n</td><td id=\"entry-200-status-code\">\n\nSuccessful. The request was successfully processed.\n\n</td></tr><tr><td>\n\n204\n\n</td><td>\n\n`Successful. No Content (Applicable only for SCIM Group Patch API)` - This 204 status is dependent on the state of the SCIM UI property, `Enable Group Patch API response with No Content`, and is subject to the attribute parameter passed as per RFC: [https://www.rfc-editor.org/rfc/rfc7644\\#page-35](https://www.rfc-editor.org/rfc/rfc7644#page-35).\n\n Default property value: false\n\n The `Enable Group Patch API response with No Content` property can be used to get additional response execution performance gains if the client does not plan to consume any response resources.\n\n</td></tr><tr><td>\n\n400\n\n</td><td>\n\nBad Request. A bad request type or malformed request was detected.-   Check for invalid values:\n    -   Malformed request body.\n    -   Required field is not provided or empty.\n    -   Invalid user or group sys\\_id is provided.\n-   Check if a read-only or immutable field is trying to be modified.\n-   Ensure that both the **attributes** and **excludedAttributes** query parameters have not been passed in the request or that the request does not exceed the maximum number of members.\n\n</td></tr><tr><td>\n\n404\n\n</td><td id=\"entry-404-status-code\">\n\nNot found. The requested item wasn't found.\n\n</td></tr><tr><td>\n\n409\n\n</td><td>\n\nGroup already exists. The **displayName** parameter must be unique.\n\n</td></tr><tr><td>\n\n500\n\n</td><td id=\"entry-500-status-code\">\n\nInternal server error. An unexpected error occurred while processing the request. The response contains additional information about the error.\n\n</td></tr></tbody>\n</table>### Response body parameters \\(JSON\\)\n\n<table><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\ncompany\n\n</td><td id=\"group_company-SCIM-entry\">\n\nDetails about the group's company or organization.Data type: Object\n\n```\n\"company\": {\n  \"display\": \"String\",\n  \"$ref\": \"String\",\n  \"value\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\ncompany.display\n\n</td><td id=\"group_company_display-SCIM-entry\">\n\nName of the company.Data type: String\n\n</td></tr><tr><td>\n\ncompany.$ref\n\n</td><td id=\"group_company_ref-SCIM-entry\">\n\nReference URI of the company.Format: `<host>/Companies/<company sys_id>`, such as: `http://instance-servicenow.com/api/now/scim/Companies/81fd65ecac1d55eb42a426568fc87a63`.\n\nData type: String\n\n</td></tr><tr><td>\n\ncompany.value\n\n</td><td id=\"group_company_value-SCIM-entry\">\n\nSys\\_id of the associated company.Data type: String\n\n</td></tr><tr><td>\n\ndisplayName\n\n</td><td id=\"group_displayName-SCIM-entry\">\n\nHuman-readable name of the group, such as HR Team.Data type: String\n\n</td></tr><tr><td>\n\nexternalId\n\n</td><td id=\"group_externalId-SCIM-entry\">\n\nUnique identifier assigned to the group by the entity provisioning it.Data type: String\n\n</td></tr><tr><td>\n\nerrors\n\n</td><td id=\"errors-SCIM-entry\">\n\nResponse that describes any errors that may have occurred during processing the request.Data type: Object\n\n```\n\"errors\": {\n  \"details\": \"String\",\n  \"schemas\": \"String\",\n  \"scimType\": \"String\",\n  \"status\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nerrors.detail\n\n</td><td id=\"errors_details-SCIM-entry\">\n\nDetailed error message on why the request failed.Data type: String\n\n</td></tr><tr><td>\n\nerrors.scimType\n\n</td><td id=\"errors_scimType-SCIM-entry\">\n\nSCIM error detail keyword.Data type: String\n\n</td></tr><tr><td>\n\nerrors.schemas\n\n</td><td id=\"errors_schemas-SCIM-entry\">\n\nURI of the SCIM Schemas used to process the error response.Data type: Array of Strings\n\n</td></tr><tr><td>\n\nerrors.status\n\n</td><td id=\"errors_status-SCIM-entry\">\n\nHTTP status code for the error response.Data type: String\n\n</td></tr><tr><td>\n\ndisplayName\n\n</td><td id=\"d3262e862\">\n\nHuman-readable name of the group, such as HR Team.Data type: String\n\n</td></tr><tr><td>\n\nexternalId\n\n</td><td id=\"d3262e874\">\n\nUnique identifier assigned to the group by the entity provisioning it.Data type: String\n\n</td></tr><tr><td>\n\nid\n\n</td><td id=\"group_id-SCIM-entry\">\n\nSys\\_id of the group.Data type: String\n\n</td></tr><tr><td>\n\nmembers\n\n</td><td id=\"group_members-SCIM-entry\">\n\nList of the users and groups associated with the group.Data type: Array of Objects\n\n```\n\"members\": [\n  {\n    \"display\": \"String\",\n    \"value\": \"String\",\n    \"$ref\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nmembers.display\n\n</td><td id=\"group_members_display-SCIM-entry\">\n\nName of the associated group member.Data type: String\n\n</td></tr><tr><td>\n\nmembers.value\n\n</td><td id=\"group_members_value-SCIM-entry\">\n\nSys\\_id of the associated user or group record.Data type: String\n\n</td></tr><tr><td>\n\nmembers.$ref\n\n</td><td id=\"group_members_ref-SCIM-entry\">\n\nURI of the associated group member.Data type: String\n\n</td></tr><tr><td>\n\nmeta\n\n</td><td id=\"group_meta-SCIM-entry\">\n\nMetadata pertaining to the group.Data type: Object\n\n```\n\"meta\": {\n  \"created\": \"String\",\n  \"lastModified\": \"String\",\n  \"location\": String\",\n  \"resourceType\": String\"\n}\n```\n\n</td></tr><tr><td>\n\nmeta.created\n\n</td><td id=\"group_meta_created-SCIM-entry\">\n\nDate and time when the group record was created.Data type: String\n\n</td></tr><tr><td>\n\nmeta.lastModified\n\n</td><td id=\"group_meta_lastModified-SCIM-entry\">\n\nDate and time when the group record was last modified.Data type: String\n\n</td></tr><tr><td>\n\nmeta.location\n\n</td><td id=\"group_meta_location-SCIM-entry\">\n\nURI of the group being retrieved.Data type: String\n\n</td></tr><tr><td>\n\nmeta.resourceType\n\n</td><td id=\"group_meta_resourceType-SCIM-entry\">\n\nSCIM Groups' resource type.Data type: String\n\n</td></tr><tr><td>\n\nschemas\n\n</td><td id=\"d3262e1000\">\n\nList of URIs of the SCIM Group schemas used to process the request.\n\nSupported group schemas:\n\n-   urn:ietf:params:scim:schemas:core:2.0:Group - Core schema specified in the Internet Engineering Task Force System for Cross-domain Identity Management: Core Schema document \\([https://datatracker.ietf.org/doc/html/rfc7643\\#section-4.2](https://datatracker.ietf.org/doc/html/rfc7643#section-4.2)\\)\n-   urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group - ServiceNow extension schema. This schema contains attributes that are present in the Groups \\[sys\\_user\\_group\\] table in a base ServiceNow system, but are not part of the core schema.\n-   urn:ietf:params:scim:schemas:extension:servicenow:custom:2.0:Group” - Custom extension schema. This schema is part of “Group” resourceType in the sys\\_scim\\_schema\\_extension table. If the schema is not active, the schema URN is not returned in the response.\n\nData type: Array of Strings\n\n</td></tr></tbody>\n</table>### cURL request\n\nThis example shows how to add an external ID to a group record and replace the current list of associated members \\(users\\).\n\n```\ncurl \"https://instance-servicenow.com/api/now/scim/Groups/a92b84f96b073010638c83eece44af4e\" \\\n--request PATCH \\\n--header \"Accept:application/scim+json\" \\\n--header \"Content-Type:application/scim+json\" \\\n--data \"{\n  \"schemas\": [\n    \"urn:ietf:params:scim:api:messages:2.0:PatchOp\"\n  ],\n  \"Operations\": [\n    {\n      \"op\": \"add\",\n      \"path\": \"externalId\",\n      \"value\": \"278fdc2e-a6aa-4140-bd23-9ba4987a2938\"\n    },\n    {\n      \"op\": \"replace\",\n      \"path\": \"members\",\n      \"value\": [\n        {\n          \"value\": \"62826bf03710200044e0bfc8bcbe5df1\"\n        },\n        {\n          \"value\": \"a8f98bb0eb32010045e1a5115206fe3a\"\n        }\n      ]\n    }\n  ]\n}\"\n```\n\nResponse:\n\n```\n{\n  \"schemas\": [\n    \"urn:ietf:params:scim:schemas:core:2.0:Group\",\n    \"urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group\",\n    'urn:ietf:params:scim:schemas:extension:servicenow:custom:2.0:Group'\n  ],\n  \"id\": \"a92b84f96b073010638c83eece44af4e\",\n  \"externalId\": \"278fdc2e-a6aa-4140-bd23-9ba4987a2938\",\n  \"meta\": {\n    \"resourceType\": \"Group\",\n    \"created\": \"2021-10-07T13:58:22Z\",\n    \"lastModified\": \"2021-10-07T15:48:44Z\",\n    \"location\":\n      \"https://instance-sevicenow/api/now/scim/Groups/a92b84f96b073010638c83eece44af4e\"\n  },\n  \"displayName\": \"HR Team\",\n  \"members\": [\n    {\n      \"value\": \"62826bf03710200044e0bfc8bcbe5df1\",\n      \"display\": \"Abel Tuter\",\n      \"$ref\":\n        \"https://instance-sevicenow/api/now/scim/Users/62826bf03710200044e0bfc8bcbe5df1\"\n    },\n    {\n      \"value\": \"a8f98bb0eb32010045e1a5115206fe3a\",\n      \"display\": \"Abraham Lincoln\",\n      \"$ref\":\n        \"https://instance-sevicenow/api/now/scim/Users/a8f98bb0eb32010045e1a5115206fe3a\"\n    }\n  ],\n  \"urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group\": {\n    \"company\": {\n      \"value\": \"81fd65ecac1d55eb42a426568fc87a63\",\n      \"name\": \"ACME Japan\",\n      \"$ref\": \"http://instance-sevicenow/api/now/scim/Companies/81fd65ecac1d55eb42a426568fc87a63\"\n    }\n  }\n}\n```\n\n## SCIM - POST /scim/Groups\n\nCreates a group record in the Group \\[sys\\_user\\_group\\] table of a ServiceNow instance using the System for Cross-domain Identity Management \\(SCIM\\) protocol.\n\nYou can define the display name of the group, an external ID used to correlate this group to an external system, and add members \\(users/groups\\) to the group.\n\n**Note:** The search and bulk modifications functionality as noted in the RFC7643 specification are not supported by this endpoint.\n\n### URL format\n\nVersioned URL: `/api/now/{api_version}/scim/Groups`\n\nDefault URL: `/api/now/scim/Groups`\n\n**Note:** Available versions are specified in the [REST API Explorer](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/use-REST-API-Explorer.md). For scripted REST APIs there is additional version information on the [Scripted REST Service form](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_CustomWebServices.md).\n\n### Supported request parameters\n\n<table class=\"rest_api_path_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\napi\\_version\n\n</td><td id=\"version-entry-RESTAPI\">\n\nOptional. Version of the endpoint to access. For example, `v1` or `v2`. Only specify this value to use an endpoint version other than the latest. Data type: String\n\n</td></tr></tbody>\n</table><table class=\"rest_api_query_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nattributes\n\n</td><td id=\"attributes-SCIM-entry\">\n\nComma-separated list of fields to return in the response. No other fields are returned.Can't be used with the **excludedAttributes** parameter.\n\nData type: String\n\nDefault: Return all fields unless **excludedAttributes** is specified.\n\n</td></tr><tr><td>\n\nexcludedAttributes\n\n</td><td id=\"excludedAttributes-SCIM-entry\">\n\nComma-separated list of fields to exclude from the records returned in the response. All other fields are returned.Can't be used with the **attributes** parameter.\n\nData type: String\n\nDefault: Do not exclude any fields.\n\n</td></tr></tbody>\n</table><table class=\"rest_api_request_body\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\ncompany\n\n</td><td id=\"group_company-SCIM-entry\">\n\nDetails about the group's company or organization.Data type: Object\n\n```\n\"company\": {\n  \"display\": \"String\",\n  \"$ref\": \"String\",\n  \"value\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\ncompany.display\n\n</td><td id=\"group_company_display-SCIM-entry\">\n\nName of the company.Data type: String\n\n</td></tr><tr><td>\n\ncompany.$ref\n\n</td><td id=\"group_company_ref-SCIM-entry\">\n\nReference URI of the company.Format: `<host>/Companies/<company sys_id>`, such as: `http://instance-servicenow.com/api/now/scim/Companies/81fd65ecac1d55eb42a426568fc87a63`.\n\nData type: String\n\n</td></tr><tr><td>\n\ncompany.value\n\n</td><td id=\"group_company_value-SCIM-entry\">\n\nSys\\_id of the associated company.Data type: String\n\n</td></tr><tr><td>\n\ndisplayName\n\n</td><td id=\"group_request_displayName-SCIM-entry\">\n\nRequired. Human-readable name of the group, such as HR Team.Data type: String\n\n</td></tr><tr><td>\n\nexternalId\n\n</td><td id=\"group_externalId-SCIM-entry\">\n\nUnique identifier assigned to the group by the entity provisioning it.Data type: String\n\n</td></tr><tr><td>\n\nmembers\n\n</td><td>\n\nList of users or other groups to associate with the group.Data type: Array of Objects\n\n ```\n\"members:\" [\n  {\n    \"value\": \"String\"\n  }\n]\n```\n\n Maximum size: 100 - You can modify this maximum size by updating the system property com.snc.interation.scim2.max.member.count.\n\n</td></tr><tr><td>\n\nmembers.value\n\n</td><td>\n\nSys\\_id of the associated user or group record.Data type: String\n\n</td></tr><tr><td>\n\nschemas\n\n</td><td id=\"group_request_schema-SCIM-entry\">\n\nRequired.List of URIs of the SCIM Group schemas used to process the request.\n\nSupported group schemas:\n\n-   urn:ietf:params:scim:schemas:core:2.0:Group - Core schema specified in the Internet Engineering Task Force System for Cross-domain Identity Management: Core Schema document \\([https://datatracker.ietf.org/doc/html/rfc7643\\#section-4.2](https://datatracker.ietf.org/doc/html/rfc7643#section-4.2)\\)\n-   urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group - ServiceNow extension schema. This schema contains attributes that are present in the Groups \\[sys\\_user\\_group\\] table in a base ServiceNow system, but are not part of the core schema.\n-   urn:ietf:params:scim:schemas:extension:servicenow:custom:2.0:Group” - Custom extension schema. This schema is part of “Group” resourceType in the sys\\_scim\\_schema\\_extension table. If the schema is not active, the schema URN is not returned in the response.\n\nData type: Array of Strings\n\n</td></tr></tbody>\n</table>### Headers\n\nThe following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table class=\"rest_api_request_headers\"><thead><tr><th>\n\nHeader\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nAccept\n\n</td><td id=\"Accept-SCIM-entry\">\n\nData format of the response body. Supported types: **application/json** or **application/scim+json**.Default: **application/json**\n\n</td></tr><tr><td>\n\nContent-Type\n\n</td><td id=\"Content_Type-SCIM-entry\">\n\nData format of the request body. Supported types: **application/json** or **application/scim+json**.Default: **application/json**\n\n</td></tr></tbody>\n</table>|Header|Description|\n|------|-----------|\n|None| |\n\n### Status codes\n\nThe following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table><thead><tr><th>\n\nStatus code\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\n201\n\n</td><td>\n\nSuccessful. The request was successfully processed.\n\n</td></tr><tr><td>\n\n400\n\n</td><td>\n\nBad Request. A bad request type or malformed request was detected.-   Check for invalid values:\n    -   Malformed request body.\n    -   Required field is not provided or empty.\n    -   Invalid user or group sys\\_id is provided.\n-   Check if a read-only or immutable field is trying to be modified.\n-   Ensure that both the **attributes** and **excludedAttributes** query parameters have not been passed in the request or that the request does not exceed the maximum number of members.\n\n</td></tr><tr><td>\n\n409\n\n</td><td id=\"status_409-SCIM-entry\">\n\nGroup already exists. The **displayName** parameter must be unique.\n\n</td></tr><tr><td>\n\n500\n\n</td><td id=\"entry-500-status-code\">\n\nInternal server error. An unexpected error occurred while processing the request. The response contains additional information about the error.\n\n</td></tr></tbody>\n</table>### Response body parameters \\(JSON\\)\n\n<table id=\"id_uwk_c5c_grb\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr id=\"group_company-SCIM-row\"><td>\n\ncompany\n\n</td><td id=\"d3262e808\">\n\nDetails about the group's company or organization.Data type: Object\n\n```\n\"company\": {\n  \"display\": \"String\",\n  \"$ref\": \"String\",\n  \"value\": \"String\"\n}\n```\n\n</td></tr><tr id=\"group_company_display-SCIM-row\"><td>\n\ncompany.display\n\n</td><td id=\"d3262e821\">\n\nName of the company.Data type: String\n\n</td></tr><tr id=\"group_company_ref-SCIM-row\"><td>\n\ncompany.$ref\n\n</td><td id=\"d3262e832\">\n\nReference URI of the company.Format: `<host>/Companies/<company sys_id>`, such as: `http://instance-servicenow.com/api/now/scim/Companies/81fd65ecac1d55eb42a426568fc87a63`.\n\nData type: String\n\n</td></tr><tr id=\"group_company_value-SCIM-row\"><td>\n\ncompany.value\n\n</td><td id=\"d3262e851\">\n\nSys\\_id of the associated company.Data type: String\n\n</td></tr><tr id=\"group_displayName-SCIM-row\"><td>\n\ndisplayName\n\n</td><td id=\"group_displayName-SCIM-entry\">\n\nHuman-readable name of the group, such as HR Team.Data type: String\n\n</td></tr><tr id=\"group_externalId-SCIM-row\"><td>\n\nexternalId\n\n</td><td id=\"d3262e874\">\n\nUnique identifier assigned to the group by the entity provisioning it.Data type: String\n\n</td></tr><tr id=\"group_id-SCIM-row\"><td>\n\nid\n\n</td><td id=\"group_id-SCIM-entry\">\n\nSys\\_id of the group.Data type: String\n\n</td></tr><tr id=\"group_meta-SCIM-row\"><td>\n\nmeta\n\n</td><td id=\"group_meta-SCIM-entry\">\n\nMetadata pertaining to the group.Data type: Object\n\n```\n\"meta\": {\n  \"created\": \"String\",\n  \"lastModified\": \"String\",\n  \"location\": String\",\n  \"resourceType\": String\"\n}\n```\n\n</td></tr><tr id=\"group_meta_created-SCIM-row\"><td>\n\nmeta.created\n\n</td><td id=\"group_meta_created-SCIM-entry\">\n\nDate and time when the group record was created.Data type: String\n\n</td></tr><tr id=\"group_meta_lastModified-SCIM-row\"><td>\n\nmeta.lastModified\n\n</td><td id=\"group_meta_lastModified-SCIM-entry\">\n\nDate and time when the group record was last modified.Data type: String\n\n</td></tr><tr id=\"group_meta_location-SCIM-row\"><td>\n\nmeta.location\n\n</td><td id=\"group_meta_location-SCIM-entry\">\n\nURI of the group being retrieved.Data type: String\n\n</td></tr><tr id=\"group_meta_resourceType-SCIM-row\"><td>\n\nmeta.resourceType\n\n</td><td id=\"group_meta_resourceType-SCIM-entry\">\n\nSCIM Groups' resource type.Data type: String\n\n</td></tr><tr id=\"group_members-SCIM-row\"><td>\n\nmembers\n\n</td><td id=\"group_members-SCIM-entry\">\n\nList of the users and groups associated with the group.Data type: Array of Objects\n\n```\n\"members\": [\n  {\n    \"display\": \"String\",\n    \"value\": \"String\",\n    \"$ref\": \"String\"\n  }\n]\n```\n\n</td></tr><tr id=\"group_members_display-SCIM-row\"><td>\n\nmembers.display\n\n</td><td id=\"group_members_display-SCIM-entry\">\n\nName of the associated group member.Data type: String\n\n</td></tr><tr id=\"group_members_value-SCIM-row\"><td>\n\nmembers.value\n\n</td><td id=\"group_members_value-SCIM-entry\">\n\nSys\\_id of the associated user or group record.Data type: String\n\n</td></tr><tr id=\"group_members_ref-SCIM-row\"><td>\n\nmembers.$ref\n\n</td><td id=\"group_members_ref-SCIM-entry\">\n\nURI of the associated group member.Data type: String\n\n</td></tr><tr id=\"group_schemas-SCIM-row\"><td>\n\nschemas\n\n</td><td id=\"group_schemas-SCIM-entry\">\n\nList of URIs of the SCIM Group schemas used to process the request.\n\nSupported group schemas:\n\n-   urn:ietf:params:scim:schemas:core:2.0:Group - Core schema specified in the Internet Engineering Task Force System for Cross-domain Identity Management: Core Schema document \\([https://datatracker.ietf.org/doc/html/rfc7643\\#section-4.2](https://datatracker.ietf.org/doc/html/rfc7643#section-4.2)\\)\n-   urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group - ServiceNow extension schema. This schema contains attributes that are present in the Groups \\[sys\\_user\\_group\\] table in a base ServiceNow system, but are not part of the core schema.\n-   urn:ietf:params:scim:schemas:extension:servicenow:custom:2.0:Group” - Custom extension schema. This schema is part of “Group” resourceType in the sys\\_scim\\_schema\\_extension table. If the schema is not active, the schema URN is not returned in the response.\n\nData type: Array of Strings\n\n</td></tr></tbody>\n</table>### cURL request POST a new group and add member\n\nThis example creates group51 and adds the user Abel Tutor as a member.\n\n```\ncurl \"https://instance-servicenow.com/api/now/scim/Groups\" \\\n--request POST \\\n--header \"Accept:application/scim+json\" \\\n--header \"Content-Type:application/scim+json\" \\\n--data \"{\n  \\\"schemas\\\": [\"urn:ietf:params:scim:schemas:core:2.0:Group\",\n    “urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group”, \n    “urn:ietf:params:scim:schemas:extension:servicenow:custom:2.0:Group”],\n  \\\"displayName\\\": \\\"HR Team\\\",\n  \\\"externalId\\\": \\\"8ae5dc9e-c7ad-4d3d-a152-35a6b6222b83\\\",\n  \\\"members\\\": [\n    {\n      \\\"value\\\": \\\"62826bf03710200044e0bfc8bcbe5df1\\\",\n      \\\"$ref\\\": \\\"Users/62826bf03710200044e0bfc8bcbe5df1\\\"\n    }\n  ]\n}\"\n```\n\nResponse:\n\n```\n{\"schemas\":\n  [\n    \"urn:ietf:params:scim:schemas:core:2.0:Group\",\n    \"urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group\",\n    'urn:ietf:params:scim:schemas:extension:servicenow:custom:2.0:Group'\n  ],\n  \"id\":\"e0140d671bbe3010593876a61a4bcb11\",\n  \"externalId\":\"8ae5dc9e-c7ad-4d3d-a152-35a6b6222b83\",\n  \"meta\":{\n    \"resourceType\":\"Group\",\n    \"created\":\"2021-09-30T18:20:43Z\",\n    \"lastModified\":\"2021-09-30T18:20:43Z\",\n    \"location\":\"https://instance-servicenow.com/api/now/scim/Groups/e0140d671bbe3010593876a61a4bcb11\"},\n    \"displayName\":\"HR Team\",\n    \"members\":[\n      {\n        \"value\":\"62826bf03710200044e0bfc8bcbe5df1\",\n        \"display\":\"Abel Tuter\",\n        \"$ref\": \"http://instance-servicenow.com/api/now/scim/Users/62826bf03710200044e0bfc8bcbe5df1\"\n      }\n    ],\n    \"urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group\": {\n      \"company\": {\n        \"value\": \"81fd65ecac1d55eb42a426568fc87a63\",\n        \"name\": \"ACME Japan\",\n        \"$ref\": http://instance-servicenow.com/api/now/scim/Companies/81fd65ecac1d55eb42a426568fc87a63\n      }\n    }\n  }\n}\n```\n\n## SCIM - PUT /scim/Groups/\\{group\\_id\\}\n\nUpdates the specified group record in the Group \\[sys\\_user\\_group\\] table of a ServiceNow instance using the System for Cross-domain Identity Management \\(SCIM\\) protocol.\n\nFields that are omitted in the request are not updated. You can explicitly clear a field by setting its value to null for a single valued field and to an empty array for array type fields such as **members**.\n\n### URL format\n\nVersioned URL: `/api/now/{api_version}/scim/Groups/{group_id}`\n\nDefault URL: `/api/now/scim/Groups/{group_id}`\n\n**Note:** Available versions are specified in the [REST API Explorer](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/use-REST-API-Explorer.md). For scripted REST APIs there is additional version information on the [Scripted REST Service form](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_CustomWebServices.md).\n\n### Supported request parameters\n\n<table class=\"rest_api_path_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\napi\\_version\n\n</td><td id=\"version-entry-RESTAPI\">\n\nOptional. Version of the endpoint to access. For example, `v1` or `v2`. Only specify this value to use an endpoint version other than the latest. Data type: String\n\n</td></tr><tr><td>\n\ngroup\\_id\n\n</td><td>\n\nSys\\_id of the group record to update.Data type: String\n\nTable: Group \\[sys\\_user\\_group\\]\n\n</td></tr></tbody>\n</table><table class=\"rest_api_query_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nattributes\n\n</td><td id=\"attributes-SCIM-entry\">\n\nComma-separated list of fields to return in the response. No other fields are returned.Can't be used with the **excludedAttributes** parameter.\n\nData type: String\n\nDefault: Return all fields unless **excludedAttributes** is specified.\n\n</td></tr><tr><td>\n\nexcludedAttributes\n\n</td><td id=\"excludedAttributes-SCIM-entry\">\n\nComma-separated list of fields to exclude from the records returned in the response. All other fields are returned.Can't be used with the **attributes** parameter.\n\nData type: String\n\nDefault: Do not exclude any fields.\n\n</td></tr></tbody>\n</table><table class=\"rest_api_request_body\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\ncompany\n\n</td><td id=\"group_company-SCIM-entry\">\n\nDetails about the group's company or organization.Data type: Object\n\n```\n\"company\": {\n  \"display\": \"String\",\n  \"$ref\": \"String\",\n  \"value\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\ncompany.display\n\n</td><td id=\"group_company_display-SCIM-entry\">\n\nName of the company.Data type: String\n\n</td></tr><tr><td>\n\ncompany.$ref\n\n</td><td id=\"group_company_ref-SCIM-entry\">\n\nReference URI of the company.Format: `<host>/Companies/<company sys_id>`, such as: `http://instance-servicenow.com/api/now/scim/Companies/81fd65ecac1d55eb42a426568fc87a63`.\n\nData type: String\n\n</td></tr><tr><td>\n\ncompany.value\n\n</td><td id=\"group_company_value-SCIM-entry\">\n\nSys\\_id of the associated company.Data type: String\n\n</td></tr><tr><td>\n\ndisplayName\n\n</td><td id=\"group_displayName-SCIM-entry\">\n\nHuman-readable name of the group, such as HR Team.Data type: String\n\n</td></tr><tr><td>\n\nexternalId\n\n</td><td id=\"group_externalId-SCIM-entry\">\n\nUnique identifier assigned to the group by the entity provisioning it.Data type: String\n\n</td></tr><tr><td>\n\nmembers\n\n</td><td>\n\nList of users to replace the current list of members with.Data type: Array of Objects\n\n ```\n\"members:\" [\n  {\n    \"value\": \"String\"\n  }\n]\n```\n\n Maximum size: 100 - You can modify this maximum size by updating the system property com.snc.interation.scim2.max.member.count.\n\n</td></tr><tr><td>\n\nmembers.value\n\n</td><td>\n\nSys\\_id of the associated user or group record.Data type: String\n\n</td></tr><tr><td>\n\nschemas\n\n</td><td id=\"group_request_schema-SCIM-entry\">\n\nRequired.List of URIs of the SCIM Group schemas used to process the request.\n\nSupported group schemas:\n\n-   urn:ietf:params:scim:schemas:core:2.0:Group - Core schema specified in the Internet Engineering Task Force System for Cross-domain Identity Management: Core Schema document \\([https://datatracker.ietf.org/doc/html/rfc7643\\#section-4.2](https://datatracker.ietf.org/doc/html/rfc7643#section-4.2)\\)\n-   urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group - ServiceNow extension schema. This schema contains attributes that are present in the Groups \\[sys\\_user\\_group\\] table in a base ServiceNow system, but are not part of the core schema.\n-   urn:ietf:params:scim:schemas:extension:servicenow:custom:2.0:Group” - Custom extension schema. This schema is part of “Group” resourceType in the sys\\_scim\\_schema\\_extension table. If the schema is not active, the schema URN is not returned in the response.\n\nData type: Array of Strings\n\n</td></tr></tbody>\n</table>### Headers\n\nThe following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table class=\"rest_api_request_headers\"><thead><tr><th>\n\nHeader\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nAccept\n\n</td><td id=\"Accept-SCIM-entry\">\n\nData format of the response body. Supported types: **application/json** or **application/scim+json**.Default: **application/json**\n\n</td></tr><tr><td>\n\nContent-Type\n\n</td><td id=\"Content_Type-SCIM-entry\">\n\nData format of the request body. Supported types: **application/json** or **application/scim+json**.Default: **application/json**\n\n</td></tr></tbody>\n</table>|Header|Description|\n|------|-----------|\n|None| |\n\n### Status codes\n\nThe following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table><thead><tr><th>\n\nStatus code\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\n200\n\n</td><td id=\"entry-200-status-code\">\n\nSuccessful. The request was successfully processed.\n\n</td></tr><tr><td>\n\n400\n\n</td><td>\n\nBad Request. A bad request type or malformed request was detected.-   Check for invalid values:\n    -   Malformed request body.\n    -   Required field is not provided or empty.\n    -   Invalid user or group sys\\_id is provided.\n-   Check if a read-only or immutable field is trying to be modified.\n-   Ensure that both the **attributes** and **excludedAttributes** query parameters have not been passed in the request or that the request does not exceed the maximum number of members.\n\n</td></tr><tr><td>\n\n404\n\n</td><td id=\"entry-404-status-code\">\n\nNot found. The requested item wasn't found.\n\n</td></tr><tr><td>\n\n409\n\n</td><td id=\"status_409-SCIM-entry\">\n\nGroup already exists. The **displayName** parameter must be unique.\n\n</td></tr><tr><td>\n\n500\n\n</td><td id=\"entry-500-status-code\">\n\nInternal server error. An unexpected error occurred while processing the request. The response contains additional information about the error.\n\n</td></tr></tbody>\n</table>### Response body parameters \\(JSON\\)\n\n<table><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\ncompany\n\n</td><td id=\"d3262e808\">\n\nDetails about the group's company or organization.Data type: Object\n\n```\n\"company\": {\n  \"display\": \"String\",\n  \"$ref\": \"String\",\n  \"value\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\ncompany.display\n\n</td><td id=\"d3262e821\">\n\nName of the company.Data type: String\n\n</td></tr><tr><td>\n\ncompany.$ref\n\n</td><td id=\"d3262e832\">\n\nReference URI of the company.Format: `<host>/Companies/<company sys_id>`, such as: `http://instance-servicenow.com/api/now/scim/Companies/81fd65ecac1d55eb42a426568fc87a63`.\n\nData type: String\n\n</td></tr><tr><td>\n\ncompany.value\n\n</td><td id=\"d3262e851\">\n\nSys\\_id of the associated company.Data type: String\n\n</td></tr><tr><td>\n\ndisplayName\n\n</td><td id=\"d3262e862\">\n\nHuman-readable name of the group, such as HR Team.Data type: String\n\n</td></tr><tr><td>\n\nerrors\n\n</td><td id=\"errors-SCIM-entry\">\n\nResponse that describes any errors that may have occurred during processing the request.Data type: Object\n\n```\n\"errors\": {\n  \"details\": \"String\",\n  \"schemas\": \"String\",\n  \"scimType\": \"String\",\n  \"status\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nerrors.detail\n\n</td><td id=\"errors_details-SCIM-entry\">\n\nDetailed error message on why the request failed.Data type: String\n\n</td></tr><tr><td>\n\nerrors.scimType\n\n</td><td id=\"errors_scimType-SCIM-entry\">\n\nSCIM error detail keyword.Data type: String\n\n</td></tr><tr><td>\n\nerrors.schemas\n\n</td><td id=\"errors_schemas-SCIM-entry\">\n\nURI of the SCIM Schemas used to process the error response.Data type: Array of Strings\n\n</td></tr><tr><td>\n\nerrors.status\n\n</td><td id=\"errors_status-SCIM-entry\">\n\nHTTP status code for the error response.Data type: String\n\n</td></tr><tr><td>\n\nexternalId\n\n</td><td id=\"d3262e874\">\n\nUnique identifier assigned to the group by the entity provisioning it.Data type: String\n\n</td></tr><tr><td>\n\nid\n\n</td><td id=\"group_id-SCIM-entry\">\n\nSys\\_id of the group.Data type: String\n\n</td></tr><tr><td>\n\nmembers\n\n</td><td id=\"group_members-SCIM-entry\">\n\nList of the users and groups associated with the group.Data type: Array of Objects\n\n```\n\"members\": [\n  {\n    \"display\": \"String\",\n    \"value\": \"String\",\n    \"$ref\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nmembers.display\n\n</td><td id=\"group_members_display-SCIM-entry\">\n\nName of the associated group member.Data type: String\n\n</td></tr><tr><td>\n\nmembers.value\n\n</td><td id=\"group_members_value-SCIM-entry\">\n\nSys\\_id of the associated user or group record.Data type: String\n\n</td></tr><tr><td>\n\nmembers.$ref\n\n</td><td id=\"group_members_ref-SCIM-entry\">\n\nURI of the associated group member.Data type: String\n\n</td></tr><tr><td>\n\nmeta\n\n</td><td id=\"group_meta-SCIM-entry\">\n\nMetadata pertaining to the group.Data type: Object\n\n```\n\"meta\": {\n  \"created\": \"String\",\n  \"lastModified\": \"String\",\n  \"location\": String\",\n  \"resourceType\": String\"\n}\n```\n\n</td></tr><tr><td>\n\nmeta.created\n\n</td><td id=\"group_meta_created-SCIM-entry\">\n\nDate and time when the group record was created.Data type: String\n\n</td></tr><tr><td>\n\nmeta.lastModified\n\n</td><td id=\"group_meta_lastModified-SCIM-entry\">\n\nDate and time when the group record was last modified.Data type: String\n\n</td></tr><tr><td>\n\nmeta.location\n\n</td><td id=\"group_meta_location-SCIM-entry\">\n\nURI of the group being retrieved.Data type: String\n\n</td></tr><tr><td>\n\nmeta.resourceType\n\n</td><td id=\"group_meta_resourceType-SCIM-entry\">\n\nSCIM Groups' resource type.Data type: String\n\n</td></tr><tr><td>\n\nschemas\n\n</td><td id=\"group_schemas-SCIM-entry\">\n\nList of URIs of the SCIM Group schemas used to process the request.\n\nSupported group schemas:\n\n-   urn:ietf:params:scim:schemas:core:2.0:Group - Core schema specified in the Internet Engineering Task Force System for Cross-domain Identity Management: Core Schema document \\([https://datatracker.ietf.org/doc/html/rfc7643\\#section-4.2](https://datatracker.ietf.org/doc/html/rfc7643#section-4.2)\\)\n-   urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group - ServiceNow extension schema. This schema contains attributes that are present in the Groups \\[sys\\_user\\_group\\] table in a base ServiceNow system, but are not part of the core schema.\n-   urn:ietf:params:scim:schemas:extension:servicenow:custom:2.0:Group” - Custom extension schema. This schema is part of “Group” resourceType in the sys\\_scim\\_schema\\_extension table. If the schema is not active, the schema URN is not returned in the response.\n\nData type: Array of Strings\n\n</td></tr></tbody>\n</table>### cURL request updating group members using PUT\n\nThe following example changes the member associated with the group to Abraham Lincoln instead of Abel Tutor and changes the name of the group to HR Team.\n\n```\ncurl \"https://instance-servicenow.com/api/now/scim/Groups/e0140d671bbe3010593876a61a4bcb11\" \\\n--request PUT \\\n--header \"Accept:application/scim+json\" \\\n--header \"Content-Type:application/scim+json\" \\\n--data \"{\n  \\\"schemas\\\": [\"urn:ietf:params:scim:schemas:core:2.0:Group\",\n    “urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group”, \n    “urn:ietf:params:scim:schemas:extension:servicenow:custom:2.0:Group”],\n  \\\"displayName\\\": \\\"HR Team\\\",\n  \\\"externalId\\\": \\\"8ae5dc9e-c7ad-4d3d-a152-35a6b6222b83\\\",\n  \\\"members\\\": [\n    {\n      \\\"value\\\": \\\"a8f98bb0eb32010045e1a5115206fe3a\\\",\n      \\\"$ref\\\": \\\"Users\\\"\n    }\n  ]\n}\" \n```\n\nResponse:\n\n```\n{\"schemas\":\n  [\n    \"urn:ietf:params:scim:schemas:core:2.0:Group\",\n    \"urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group\",\n    'urn:ietf:params:scim:schemas:extension:servicenow:custom:2.0:Group'\n  ],\n  \"id\":\"e0140d671bbe3010593876a61a4bcb11\",\n  \"externalId\":\"8ae5dc9e-c7ad-4d3d-a152-35a6b6222b83\",\n  \"meta\":{\n    \"resourceType\":\"Group\",\n    \"created\":\"2021-09-30T18:20:43Z\",\n    \"lastModified\":\"2021-09-30T21:19:40Z\",\n    \"location\":\"https://instance-servicenow.com/api/now/scim/Groups/e0140d671bbe3010593876a61a4bcb11\"\n  },\n  \"displayName\":\"HR Team\",\n  \"members\":[\n    {\n      \"value\":\"a8f98bb0eb32010045e1a5115206fe3a\",\n      \"display\":\"Abraham Lincoln\",\n      \"$ref\": \"http://instance-servicenow.com/api/now/scim/Users/62826bf03710200044e0bfc8bcbe5df1\"\n    }\n  ],\n  \"urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group\": {\n    \"company\": {\n      \"value\": \"81fd65ecac1d55eb42a426568fc87a63\",\n      \"name\": \"ACME Japan\",\n      \"$ref\": \"http://192.168.1.25:8080/api/now/scim/Companies/81fd65ecac1d55eb42a426568fc87a63\"\n    }\n  }\n}\n```\n\n## SCIM - DELETE /scim/Users/\\{user\\_id\\}\n\nDeletes the specified user record from the User \\[sys\\_user\\] table of a ServiceNow instance using the System for Cross-domain Identity Management \\(SCIM\\) protocol.\n\n### URL format\n\nVersioned URL: `/api/now/{api_version}/scim/Users/{user_id}`\n\nDefault URL: `/api/now/scim/Users/{user_id}`\n\n**Note:** Available versions are specified in the [REST API Explorer](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/use-REST-API-Explorer.md). For scripted REST APIs there is additional version information on the [Scripted REST Service form](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_CustomWebServices.md).\n\n### Supported request parameters\n\n<table class=\"rest_api_path_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\napi\\_version\n\n</td><td id=\"version-entry-RESTAPI\">\n\nOptional. Version of the endpoint to access. For example, `v1` or `v2`. Only specify this value to use an endpoint version other than the latest. Data type: String\n\n</td></tr><tr><td>\n\nuser\\_id\n\n</td><td>\n\nSys\\_id of the user record to delete.Data type: String\n\nTable: User \\[sys\\_user\\]\n\n</td></tr></tbody>\n</table>|Name|Description|\n|----|-----------|\n|None| |\n\n|Name|Description|\n|----|-----------|\n|None| |\n\n### Headers\n\nThe following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table class=\"rest_api_request_headers\"><thead><tr><th>\n\nHeader\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nAccept\n\n</td><td id=\"Accept-SCIM-entry\">\n\nData format of the response body. Supported types: **application/json** or **application/scim+json**.Default: **application/json**\n\n</td></tr></tbody>\n</table>|Header|Description|\n|------|-----------|\n|None| |\n\n### Status codes\n\nThe following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n|Status code|Description|\n|-----------|-----------|\n|204|No Content. The request was successfully processed.|\n|404|Not found. The requested item wasn't found.|\n\n### Response body parameters \\(JSON\\)\n\n<table><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nerrors\n\n</td><td id=\"errors-SCIM-entry\">\n\nResponse that describes any errors that may have occurred during processing the request.Data type: Object\n\n```\n\"errors\": {\n  \"details\": \"String\",\n  \"schemas\": \"String\",\n  \"scimType\": \"String\",\n  \"status\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nerrors.detail\n\n</td><td id=\"errors_details-SCIM-entry\">\n\nDetailed error message on why the request failed.Data type: String\n\n</td></tr><tr><td>\n\nerrors.scimType\n\n</td><td id=\"errors_scimType-SCIM-entry\">\n\nSCIM error detail keyword.Data type: String\n\n</td></tr><tr><td>\n\nerrors.schemas\n\n</td><td id=\"errors_schemas-SCIM-entry\">\n\nURI of the SCIM Schemas used to process the error response.Data type: Array of Strings\n\n</td></tr><tr><td>\n\nerrors.status\n\n</td><td id=\"errors_status-SCIM-entry\">\n\nHTTP status code for the error response.Data type: String\n\n</td></tr></tbody>\n</table>### cURL request\n\nThis example shows how to delete a user record from the User \\[sys\\_user\\] table.\n\n```\ncurl \"https://instance-servicenow.com/api/now/scim/Users/b7c5015f778330102e8cc5179e5a9992\" \\\n--request DELETE \\\n--header \"Accept:application/scim+json\"  \\\n```\n\n## SCIM - GET /scim/Users\n\nReturns one or more user records from the User \\[sys\\_user\\] table within a ServiceNow instance using the System for Cross-domain Identity Management \\(SCIM\\) protocol.\n\n**Note:** A query that does not return any matches returns success \\(HTTP status code 200\\) with **totalResults** set to 0.\n\n### URL format\n\nVersioned URL: `/api/now/{api_version}/scim/Users`\n\nDefault URL: `/api/now/scim/Users`\n\n**Note:** Available versions are specified in the [REST API Explorer](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/use-REST-API-Explorer.md). For scripted REST APIs there is additional version information on the [Scripted REST Service form](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_CustomWebServices.md).\n\n### Supported request parameters\n\n<table class=\"rest_api_path_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\napi\\_version\n\n</td><td id=\"version-entry-RESTAPI\">\n\nOptional. Version of the endpoint to access. For example, `v1` or `v2`. Only specify this value to use an endpoint version other than the latest. Data type: String\n\n</td></tr></tbody>\n</table><table class=\"rest_api_query_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nattributes\n\n</td><td id=\"attributes-SCIM-entry\">\n\nComma-separated list of fields to return in the response. No other fields are returned.Can't be used with the **excludedAttributes** parameter.\n\nData type: String\n\nDefault: Return all fields unless **excludedAttributes** is specified.\n\n</td></tr><tr><td>\n\ncount\n\n</td><td id=\"count-SCIM-entry\">\n\nNumber of records to return. A negative value is interpreted as zero.Data type: Number\n\nMaximum: 500 - A value greater than this results in a bad request error.\n\nDefault: 10\n\n</td></tr><tr><td>\n\nexcludedAttributes\n\n</td><td id=\"excludedAttributes-SCIM-entry\">\n\nComma-separated list of fields to exclude from the records returned in the response. All other fields are returned.Can't be used with the **attributes** parameter.\n\nData type: String\n\nDefault: Do not exclude any fields.\n\n</td></tr><tr><td>\n\nfilter\n\n</td><td id=\"user_filter-SCIM-entry\">\n\nFilter expression to apply to the return results. Field filters are expressed as `<field_name> <operator> <\"value\">`. Refer to [RFC7644](https://datatracker.ietf.org/doc/html/rfc7644#section-3.4.2) for a list of the valid operators. **Note:** The `NOT` operator is not supported.\n\nFor example, to filter for all users whose name starts with \"Jo\", enter `userName SW \"jo\"` \\(case-insensitive\\).\n\nTo specify more than one field filter, concatenate the filters using the `AND` operand. For example, to filter for all users whose name starts with \"Jo\" and whose last name contains \"smi\", enter `userName SW \"john\" AND name.familyName CO \"smi\"`. Use dot-walking to specify nested attributes.\n\nOnly the following SCIM user fields are available for use in filters and some, as noted, only support fixed format:\n\n-   active\n-   addresses - Fixed format only, such as:\n    -   \\[type eq \"home\" and streetAddress eq \"xxxx\"\\]\n    -   \\[type eq \"home\" and locality eq \"xxxx\"\\]\n    -   \\[type eq \"home\" and region eq \"xxxx\"\\]\n    -   \\[type eq \"home\" and postalCode eq \"xxxx\"\\]\n    -   \\[type eq \"home\" and country eq \"xxxx\"\\]\n-   displayName\n-   emails - Fixed format only, such as: \\[type eq \"work\" and value eq \"emailValue\"\\]\n-   externalId - Only `EQ` operator is supported.\n-   id\n-   meta.created\n-   meta.lastModified\n-   name.familyName\n-   name.givenName\n-   name.middleName\n-   preferredLanguage\n-   phoneNumbers - Fixed format only, such as:\n    -   \\[type eq “work” and value eq “xxxx”\\]\n    -   \\[type eq “mobile” and value eq “xxxx”\\]\n    -   \\[type eq “home” and value eq “xxxx”\\]\n-   timezone\n-   title\n-   userName\n-   urn:ietf:params:scim:schemas:extension:servicenow:2.0:User:employeeNumber\n-   urn:ietf:params:scim:schemas:extension:servicenow:2.0:User:gender\n-   urn:ietf:params:scim:schemas:extension:servicenow:2.0:User:department.name\n-   urn:ietf:params:scim:schemas:extension:servicenow:2.0:User:department.value\n-   urn:ietf:params:scim:schemas:extension:servicenow:2.0:User:manager.displayName\n-   urn:ietf:params:scim:schemas:extension:servicenow:2.0:User:manager.value\n-   urn:ietf:params:scim:schemas:extension:servicenow:2.0:User:costCenter.name\n-   urn:ietf:params:scim:schemas:extension:servicenow:2.0:User:costCenter.value\n-   urn:ietf:params:scim:schemas:extension:servicenow:2.0:User:company.name\n-   urn:ietf:params:scim:schemas:extension:servicenow:2.0:User:company.value\n-   urn:ietf:params:scim:schemas:extension:servicenow:2.0:User:location.name\n-   urn:ietf:params:scim:schemas:extension:servicenow:2.0:User:location.value\n\nData type: String\n\nDefault: No filtering\n\n</td></tr><tr><td>\n\nsortBy\n\n</td><td id=\"user_sortBy-SCIM-entry\">\n\nMust be specified with the **sortOrder** parameter. Field by which to sort the return results. Sorting is case-insensitive. You can only use the parameters available for filtering for the **sortBy** parameter, with the exception of **externalId**, which is not allowed.\n\nAlso, only the following dot-walked parameters are supported:\n\n-   **addressess** - Only the following values are allowed:\n    -   **addresses.streetAddress** - Maps to home street address.\n    -   **addresses.home.streetAddress**\n    -   **addresses.locality** - Maps to home locality.\n    -   **addresses.home.locality**\n    -   **addresses.region** - Maps to home region.\n    -   **addresses.home.region**\n    -   **addresses.postalCode** - Maps to home postal code.\n    -   **addresses.home.postalCode**\n    -   **addresses.country** - Maps to home country.\n    -   **addresses.home.country**\n-   **emails** - Only the following values are allowed:\n    -   **emails.value** - Maps to the email type work.\n    -   **emails.work.value**\n-   **phoneNumbers** - Only the following values are allowed:\n    -   **phoneNumbers.value** - Maps to the phone number type work.\n    -   **phoneNumbers.home.value**\n    -   **phoneNumbers.mobile.value**\n    -   **phoneNumbers.work.value**\n\nFor values that are null:\n\n-   sorted by ascending - Null values are sorted to the top.\n-   sorted by descending - Null values are sorted to the bottom.\n\nData type: String\n\nDefault: No sort performed\n\n</td></tr><tr><td>\n\nsortOrder\n\n</td><td id=\"sortOrder-SCIM-entry\">\n\nMust be specified with the **sortBy** parameter. Order in which the **sortBy** parameter is applied to the return results. Valid values:\n\n-   ascending\n-   descending\n\nData type: String\n\nDefault: ascending\n\n</td></tr><tr><td>\n\nstartIndex\n\n</td><td id=\"user_startIndex-SCIM-entry\">\n\nOne-based index into the User \\[sys\\_user\\] table at which to start retrieving records. For example, if you set this parameter to 100, and the **count** parameter to 20, the endpoint returns records 100 through 119. **Note:** Any value that is set to less than one is interpreted as one.\n\nNot valid with the **id** path parameter.\n\nData type: String\n\nDefault: 1\n\n</td></tr></tbody>\n</table>|Name|Description|\n|----|-----------|\n|None| |\n\n### Headers\n\nThe following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table class=\"rest_api_request_headers\"><thead><tr><th>\n\nHeader\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nAccept\n\n</td><td id=\"Accept-SCIM-entry\">\n\nData format of the response body. Supported types: **application/json** or **application/scim+json**.Default: **application/json**\n\n</td></tr></tbody>\n</table>|Header|Description|\n|------|-----------|\n|None| |\n\n### Status codes\n\nThe following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table><thead><tr><th>\n\nStatus code\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\n200\n\n</td><td id=\"entry-200-status-code\">\n\nSuccessful. The request was successfully processed.\n\n</td></tr><tr><td>\n\n400\n\n</td><td id=\"status_400-SCIM-entry\">\n\nBad Request. A bad request type or malformed request was detected.-   Ensure that both the **attributes** and **excludedAttributes** query parameters have not been passed in the request.\n-   Ensure that the **count** parameter is not greater than 500.\n-   Ensure that all **filter** parameters are valid.\n\n</td></tr></tbody>\n</table>### Response body parameters \\(JSON\\)\n\n<table><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nitemsPerPage\n\n</td><td id=\"itemsPerPage-SCIM-entry\">\n\nNumber of records returned in the return results.Data type: Number\n\n</td></tr><tr><td>\n\nResources\n\n</td><td>\n\nList of user records.Data type: Array of Objects\n\n ```\n\"Resources\": [\n  {\n    \"active\": Boolean,\n    \"addresses\": {Object},\n    \"displayName\": \"String\",\n    \"emails\": [Array],\n    \"externalId\": \"String\",\n    \"groups\": [Array],\n    \"id\": \"String\",\n    \"meta\": {Object},\n    \"name\": {Object},\n    \"phoneNumbers\": [Array],\n    \"preferredLanguage\": \"String\",\n    \"schemas\": [Array],\n    \"timezone\": \"String\",\n    \"title\": \"String\",\n    \"userName\": \"String\",\n    \"userType\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nResources.active\n\n</td><td>\n\nFlag that indicates whether the associated user is active within the ServiceNow instance.Possible values:\n\n-   true: User is active.\n-   false: User is inactive.\n\nData type: Boolean\n\n</td></tr><tr><td>\n\nResources.adresses\n\n</td><td>\n\nDetails of the user's current mailing address.Data type: Object\n\n```\n\"addresses\": {\n  \"country\": \"String\",\n  \"locality\": \"String\",\n  \"postalCode\": \"String\",\n  \"region\": \"String\",\n  \"streetAddress\": \"String\",\n  \"type\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nResources.addresses.country\n\n</td><td>\n\nCountry name.Data type: String\n\n</td></tr><tr><td>\n\nResources.addresses.locality\n\n</td><td>\n\nCity or locality name.Data type: String\n\n</td></tr><tr><td>\n\nResources.addresses.postalCode\n\n</td><td>\n\nZip or postal code.Data type: String\n\n</td></tr><tr><td>\n\nResources.addresses.region\n\n</td><td>\n\nState or region.Data type: String\n\n</td></tr><tr><td>\n\nResources.addresses.streetAddress\n\n</td><td>\n\nFull street address. This can include the house number, street name, PO Box, and multi-line extended street address information.Data type: String\n\n</td></tr><tr><td>\n\nResources.addresses.type\n\n</td><td>\n\nType of address. Currently only supports `home`.Data type: String\n\n</td></tr><tr><td>\n\nResources.displayName\n\n</td><td>\n\nUser display name. This value is auto-generated by concatenating the **name** fields. Data type: String\n\n</td></tr><tr><td>\n\nResources.emails\n\n</td><td>\n\nList of email accounts associated with the user.Data type: Array of Objects\n\n```\n\"emails:\" [\n  {\n    \"type\": \"String\",\n    \"value\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nResources.emails.type\n\n</td><td>\n\nUser email type. Currently only supports type of \"work\".Data type: String\n\n</td></tr><tr><td>\n\nResources.emails.value\n\n</td><td>\n\nUser's email address. This is a unique key for the associated user.Data type: String\n\n</td></tr><tr><td>\n\nResources.externalId\n\n</td><td>\n\nUnique identifier assigned to the user by the entity provisioning it.Data type: String\n\n</td></tr><tr><td>\n\nResources.groups\n\n</td><td>\n\nList of groups to which the user belongs, either through direct membership, nested groups, or dynamically calculated.Data type: Array of Objects\n\n```\n\"groups\": [\n  {\n    \"display\": \"String\",\n    \"type\": \"String\",\n    \"value\": \"String\",\n    \"$ref\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nResources.groups.display\n\n</td><td>\n\nName of the associated group.Data type: String\n\n</td></tr><tr><td>\n\nResources.groups.type\n\n</td><td>\n\nType of group association, such as direct or indirect.Data type: String\n\n</td></tr><tr><td>\n\nResources.groups.value\n\n</td><td>\n\nSys\\_id of an associated group record.Data type: String\n\n</td></tr><tr><td>\n\nResources.groups.ref\n\n</td><td>\n\nURI of the associated group.Data type: String\n\n</td></tr><tr><td>\n\nResources.id\n\n</td><td>\n\nSys\\_id of the associated User record.Data type: String\n\n</td></tr><tr><td>\n\nResources.meta\n\n</td><td>\n\nMetadata pertaining to the user.Data type: Object\n\n```\n\"meta\": {\n  \"created\": \"String\",\n  \"lastModified\": \"String\",\n  \"location\": String\",\n  \"resourceType\": String\"\n}\n```\n\n</td></tr><tr><td>\n\nResources.meta.created\n\n</td><td>\n\nDate and time when the user record was created.Data type: String\n\n</td></tr><tr><td>\n\nResources.meta.lastModified\n\n</td><td>\n\nDate and time when the user record was last modified.Data type: String\n\n</td></tr><tr><td>\n\nResources.meta.location\n\n</td><td>\n\nURI of the user being retrieved.Data type: String\n\n</td></tr><tr><td>\n\nResources.meta.resourceType\n\n</td><td>\n\nSCIM Users' resource type.Data type: String\n\n</td></tr><tr><td>\n\nResources.name\n\n</td><td>\n\nUser's name information.Data type: Object\n\n```\n\"name\": {\n  \"familyName\": \"String\",\n  \"givenName\": \"String\",\n  \"honorificPrefix\": \"String\",\n  \"middleName\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nResources.name.familyName\n\n</td><td>\n\nUser's family or last name.Data type: String\n\n</td></tr><tr><td>\n\nResources.name.givenName\n\n</td><td>\n\nUser's given or first name.Data type: String\n\n</td></tr><tr><td>\n\nResources.name.honorificPrefix\n\n</td><td>\n\nUser's honorific name or title, such as Dr., Bishop, or Baron.Data type: String\n\n</td></tr><tr><td>\n\nResources.name.middle\n\n</td><td>\n\nUser's middle name.Data type: String\n\n</td></tr><tr><td>\n\nResources.phoneNumbers\n\n</td><td>\n\nList of phone numbers associated with the user.Data type: Array of Objects\n\n```\n\"phoneNumbers\": [\n  {\n    \"type\": \"String\",\n    \"value\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nResources.phoneNumbers.type\n\n</td><td>\n\nType of phone number.Possible values:\n\n-   home\n-   mobile\n-   work\n\nData type: String\n\n</td></tr><tr><td>\n\nResources.phoneNumbers.value\n\n</td><td>\n\nUser's phone number.Data type: String\n\n</td></tr><tr><td>\n\nResources.preferredLanguage\n\n</td><td>\n\nUser's preferred spoken and written language.Data type: String\n\n</td></tr><tr><td>\n\nResources.schemas\n\n</td><td>\n\nList of URIs of the SCIM User schemas used to process the request.Data type: Array of Strings\n\n</td></tr><tr><td>\n\nResources.timezone\n\n</td><td>\n\nUser's time zone.Data type: String\n\n</td></tr><tr><td>\n\nResources.title\n\n</td><td>\n\nUser's title, such as CEO or President.Data type: String\n\n</td></tr><tr><td>\n\nResources.userName\n\n</td><td>\n\nUnique user name for the associated user. Data type: String\n\n</td></tr><tr><td>\n\nResources.userType\n\n</td><td>\n\nUser type. This value is used to identify the organization to user relationship.This can be any value, but typical values might include:\n\n-   Contractor\n-   Employee\n-   Intern\n-   Temp\n-   External\n-   Unknown\n\nData type: String\n\n</td></tr><tr><td>\n\nschemas\n\n</td><td id=\"user_schemas-SCIM-entry\">\n\nList of URIs of the SCIM ListResponse schemas used to process the request.Data type: Array of Strings\n\n</td></tr><tr><td>\n\nstartIndex\n\n</td><td>\n\nOne-based index into the User \\[sys\\_user\\] table at which the records were returned.Data type: String\n\n</td></tr><tr><td>\n\ntotalResults\n\n</td><td id=\"totalResults-SCIM-entry\">\n\nTotal number of records that match the request.Data type: Number\n\n</td></tr></tbody>\n</table>### Extension parameters returned\n\n<table id=\"id_hmw_fjk_grb\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr id=\"user_company-SCIM-row\"><td>\n\ncompany\n\n</td><td id=\"user_company-SCIM-entry\">\n\nDetails about the user's associated company.Data type: Object\n\n```\n\"company\": {\n  \"display\": \"String\",\n  \"value\": \"String\",\n  \"$ref\": \"String\"\n}\n```\n\n</td></tr><tr id=\"user_company_display-SCIM-row\"><td>\n\ncompany.display\n\n</td><td id=\"user_company_display-SCIM-entry\">\n\nName of the company.Data type: String\n\n</td></tr><tr id=\"user_company_value-SCIM-row\"><td>\n\ncompany.value\n\n</td><td id=\"user_company_value-SCIM-entry\">\n\nSys\\_id of the company record.Data type: String\n\n</td></tr><tr id=\"user_company_ref-SCIM-row\"><td>\n\ncompany.$ref\n\n</td><td id=\"user_company_ref-SCIM-entry\">\n\nReference URI for the company.Data type: String\n\n</td></tr><tr id=\"user_costCenter-SCIM-row\"><td>\n\ncostCenter\n\n</td><td id=\"user_costCenter-SCIM-entry\">\n\nDetails about the user's associated cost center.Data type: Object\n\n```\n\"costCenter\": {\n  \"display\": \"String\",\n  \"value\": \"String\",\n  \"$ref\": \"String\"\n}\n```\n\n</td></tr><tr id=\"user_costCenter_display-SCIM-row\"><td>\n\ncostCenter.display\n\n</td><td id=\"user_costCenter_display-SCIM-entry\">\n\nName of the cost center.Data type: String\n\n</td></tr><tr id=\"user_costCenter_value-SCIM-row\"><td>\n\ncostCenter.value\n\n</td><td id=\"user_costCenter_value-SCIM-entry\">\n\nSys\\_id of the cost center record. Data type: String\n\n</td></tr><tr id=\"user_costCenter_ref-SCIM-row\"><td>\n\ncostCenter.$ref\n\n</td><td id=\"user_costCenter_ref-SCIM-entry\">\n\nReference URI for the cost center.Data type: String\n\n</td></tr><tr id=\"user_department-SCIM-row\"><td>\n\ndepartment\n\n</td><td id=\"user_department-SCIM-entry\">\n\nDetails about the user's associated department.Data type: Object\n\n```\n\"department\": {\n  \"display\": \"String\",\n  \"value\": \"String\",\n  \"$ref\": \"String\"\n}\n```\n\n</td></tr><tr id=\"user_department_display-SCIM-row\"><td>\n\ndepartment.display\n\n</td><td id=\"user_department_display-SCIM-entry\">\n\nName of the department.Data type: String\n\n</td></tr><tr id=\"user_department_value-SCIM-row\"><td>\n\ndepartment.value\n\n</td><td id=\"user_department_value-SCIM-entry\">\n\nSys\\_id of the department record. Data type: String\n\n</td></tr><tr id=\"user_department_ref-SCIM-row\"><td>\n\ndepartment.$ref\n\n</td><td id=\"user_department_ref-SCIM-entry\">\n\nReference URI for the department.Data type: String\n\n</td></tr><tr id=\"user_employeeNumber-SCIM-row\"><td>\n\nemployeeNumber\n\n</td><td id=\"user_employeeNumber-SCIM-entry\">\n\nNumeric or alphanumeric employee number.Data type: String\n\n</td></tr><tr id=\"user_gender-SCIM-row\"><td>\n\ngender\n\n</td><td id=\"user_gender-SCIM-entry\">\n\nGender of the user, such as male or female.Data type: String\n\n</td></tr><tr id=\"user_location-SCIM-row\"><td>\n\nlocation\n\n</td><td id=\"user_location-SCIM-entry\">\n\nDetails about the user's associated location.Data type: Object\n\n```\n\"location\": {\n  \"display\": \"String\",\n  \"value\": \"String\",\n  \"$ref\": \"String\"\n}\n```\n\n</td></tr><tr id=\"user_location_display-SCIM-row\"><td>\n\nlocation.display\n\n</td><td id=\"user_location_display-SCIM-entry\">\n\nName of the location.Data type: String\n\n</td></tr><tr id=\"user_location_value-SCIM-row\"><td>\n\nlocation.value\n\n</td><td id=\"user_location_value-SCIM-entry\">\n\nSys\\_id of the location record. Data type: String\n\n</td></tr><tr id=\"user_location_ref-SCIM-row\"><td>\n\nlocation.$ref\n\n</td><td id=\"user_location_ref-SCIM-entry\">\n\nReference URI for the location.Data type: String\n\n</td></tr><tr id=\"user_manager-SCIM-row\"><td>\n\nmanager\n\n</td><td id=\"user_manager-SCIM-entry\">\n\nDetails about the user's associated manager.Data type: Object\n\n```\n\"manager\": {\n  \"display\": \"String\",\n  \"value\": \"String\",\n  \"$ref\": \"String\"\n}\n```\n\n</td></tr><tr id=\"user_manager_display-SCIM-row\"><td>\n\nmanager.display\n\n</td><td id=\"user_manager_display-SCIM-entry\">\n\nName of the manager.Data type: String\n\n</td></tr><tr id=\"user_manager_value-SCIM-row\"><td>\n\nmanager.value\n\n</td><td id=\"user_manager_value-SCIM-entry\">\n\nSys\\_id of the manager record. Data type: String\n\n</td></tr><tr id=\"user_manager_ref-SCIM-row\"><td>\n\nmanager.$ref\n\n</td><td id=\"user_manager_ref-SCIM-entry\">\n\nReference URI for the manager.Data type: String\n\n</td></tr></tbody>\n</table>### cURL request using attributes\n\nThe following example shows how to obtain two users starting at the sixth record and only returning the display name.\n\n```\ncurl \"https://instance-servicenow.com/api/now/scim/Users?attributes=displayName&startIndex=6&count=2\" \\\n--request GET \\\n--header \"Accept:application/scim+json\" \\\n```\n\nResponse:\n\n```\n{\"schemas\":\n  [\"urn:ietf:params:scim:api:messages:2.0:ListResponse\"],\n  \"totalResults\":619,\n  \"Resources\":\n    [\n      {\n        \"schemas\":\n          [\n            \"urn:ietf:params:scim:schemas:extension:servicenow:2.0:User\",\n            \"urn:ietf:params:scim:schemas:core:2.0:User\"\n          ],\n        \"id\":\"02826bf03710200044e0bfc8bcbe5d6d\",\n        \"displayName\":\"Sean Bonnet\"\n      },\n      {\n        \"schemas\":\n          [\n            \"urn:ietf:params:scim:schemas:extension:servicenow:2.0:User\",\n            \"urn:ietf:params:scim:schemas:core:2.0:User\"\n           ],\n         \"id\":\"02826bf03710200044e0bfc8bcbe5d76\",\n         \"displayName\":\"Jacinto Gawron\"\n      }\n    ],\n  \"startIndex\":6,\n  \"itemsPerPage\":2\n}\n```\n\n### cURL request using a filter\n\nThe following example shows how to use the **filter** parameter to return the first two user records whose given name starts with \"a\".\n\n```\ncurl \"https://instance-servicenow.com/api/now/scim/Users?filter=name.givenName%20SW%20%22a%22&count=2\" \\\n--request GET \\\n--header \"Accept:application/scim+json\" \\\n```\n\nResponse:\n\n```\n{\"schemas\":\n  [\"urn:ietf:params:scim:api:messages:2.0:ListResponse\"],\n  \"totalResults\":42,\n  \"Resources\":\n    [\n      {\n        \"schemas\":\n          [\n            \"urn:ietf:params:scim:schemas:extension:servicenow:2.0:User\",\n            \"urn:ietf:params:scim:schemas:core:2.0:User\"\n          ],\n        \"id\":\"06826bf03710200044e0bfc8bcbe5d8a\",\n        \"meta\":\n          {\n            \"resourceType\":\"User\",\n            \"created\":\"2012-02-18T03:04:50Z\",\n            \"lastModified\":\"2021-10-01T14:23:32Z\",\n            \"location\":\"https://instance-servicenow.com/api/now/scim/Users/06826bf03710200044e0bfc8bcbe5d8a\"\n          },\n          \"userName\":\"allyson.gillispie\",\n          \"name\":\n            {\n              \"familyName\":\"Gillispie\",\n              \"givenName\":\"Allyson\"\n            },\n          \"displayName\":\"Allyson Gillispie\",\n          \"active\":true,\n          \"emails\":\n            [\n              {\n                \"value\":\"allyson.gillispie@example.com\",\n                \"type\":\"work\"\n              }\n            ],\n          \"urn:ietf:params:scim:schemas:extension:servicenow:2.0:User\":\n            {\n              \"gender\":\"Female\",\n              \"costCenter\":\n                {\n                  \"value\":\"d9d07bddc0a80a647cf932056ed24652\",\n                  \"name\":\"Engineering\"\n                },\n              \"company\":\n                {\n                  \"value\":\"31bea3d53790200044e0bfc8bcbe5dec\",\n                  \"name\":\"ACME North America\"\n                },\n              \"department\":\n                {\n                  \"value\":\"221f3db5c6112284009f4becd3039cc9\",\n                  \"name\":\"Development\"\n                },\n              \"location\":\n                {\n                  \"value\":\"f9084ba00a0a0b910060ba2ce83f882b\",\n                  \"name\":\"946 Donax Avenue, Imperial Beach,CA\"\n                }\n            }\n         },\n      {\n        \"schemas\":\n          [\n            \"urn:ietf:params:scim:schemas:extension:servicenow:2.0:User\",\n            \"urn:ietf:params:scim:schemas:core:2.0:User\"\n          ],\n        \"id\":\"0a826bf03710200044e0bfc8bcbe5d7a\"\n        \"meta\":\n          {\n            \"resourceType\":\"User\",\n            \"created\":\"2012-02-18T03:04:50Z\",\n            \"lastModified\":\"2021-10-01T14:23:32Z\",\n            \"location\":\"https://instance-servicenow.com/api/now/scim/Users/0a826bf03710200044e0bfc8bcbe5d7a\"\n          },\n        \"userName\":\"adela.cervantsz\",\n        \"name\":\n          {\n            \"familyName\":\"Cervantsz\",\n            \"givenName\":\"Adela\"\n          },\n        \"displayName\":\"Adela Cervantsz\",\n        \"active\":true,\n        \"emails\":\n          [\n            {\n              \"value\":\"adela.cervantsz@example.com\",\n              \"type\":\"work\"\n            }\n          ],\n        \"urn:ietf:params:scim:schemas:extension:servicenow:2.0:User\":\n          {\n            \"gender\":\"Female\",\n            \"costCenter\":\n              {\n                \"value\":\"91e8bbf43710200044e0bfc8bcbe5daa\",\n                \"name\":\"Customer Support\"\n              },\n            \"company\":\n              {\n                \"value\":\"31bea3d53790200044e0bfc8bcbe5dec\",\n                \"name\":\"ACME North America\"\n              },\n            \"department\":\n              {\n                \"value\":\"5d7f17f03710200044e0bfc8bcbe5d43\",\n                \"name\":\"Customer Support\"\n              },\n            \"location\":\n              {\n                \"value\":\"25ab93750a0a0bb30067bd2ef3d4a5c9\",\n                \"name\":\"8306 Mills Drive, Miami,FL\"\n              }\n          }\n    }\n  ],\n  \"startIndex\":1,\n  \"itemsPerPage\":2\n}\n```\n\n## SCIM - GET /scim/Users/\\{user\\_id\\}\n\nReturns the specified user record from the User \\[sys\\_user\\] table within a ServiceNow instance using the System for Cross-domain Identity Management \\(SCIM\\) protocol.\n\n### URL format\n\nVersioned URL: `/api/now/{api_version}/scim/Users/{user_id}`\n\nDefault URL: `/api/now/scim/Users/{user_id}`\n\n**Note:** Available versions are specified in the [REST API Explorer](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/use-REST-API-Explorer.md). For scripted REST APIs there is additional version information on the [Scripted REST Service form](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_CustomWebServices.md).\n\n### Supported request parameters\n\n<table class=\"rest_api_path_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\napi\\_version\n\n</td><td id=\"version-entry-RESTAPI\">\n\nOptional. Version of the endpoint to access. For example, `v1` or `v2`. Only specify this value to use an endpoint version other than the latest. Data type: String\n\n</td></tr><tr><td>\n\nuser\\_id\n\n</td><td>\n\nSys\\_id of the user record to return.Data type: String\n\nTable: User \\[sys\\_user\\]\n\n</td></tr></tbody>\n</table><table class=\"rest_api_query_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nattributes\n\n</td><td id=\"attributes-SCIM-entry\">\n\nComma-separated list of fields to return in the response. No other fields are returned.Can't be used with the **excludedAttributes** parameter.\n\nData type: String\n\nDefault: Return all fields unless **excludedAttributes** is specified.\n\n</td></tr><tr><td>\n\nexcludedAttributes\n\n</td><td id=\"excludedAttributes-SCIM-entry\">\n\nComma-separated list of fields to exclude from the records returned in the response. All other fields are returned.Can't be used with the **attributes** parameter.\n\nData type: String\n\nDefault: Do not exclude any fields.\n\n</td></tr></tbody>\n</table>|Name|Description|\n|----|-----------|\n|None| |\n\n### Headers\n\nThe following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table class=\"rest_api_request_headers\"><thead><tr><th>\n\nHeader\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nAccept\n\n</td><td id=\"Accept-SCIM-entry\">\n\nData format of the response body. Supported types: **application/json** or **application/scim+json**.Default: **application/json**\n\n</td></tr></tbody>\n</table>|Header|Description|\n|------|-----------|\n|None| |\n\n### Status codes\n\nThe following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table><thead><tr><th>\n\nStatus code\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\n200\n\n</td><td id=\"entry-200-status-code\">\n\nSuccessful. The request was successfully processed.\n\n</td></tr><tr><td>\n\n400\n\n</td><td id=\"status_400-SCIM-entry\">\n\nBad Request. A bad request type or malformed request was detected.-   Ensure that both the **attributes** and **excludedAttributes** query parameters have not been passed in the request.\n-   Ensure that the **count** parameter is not greater than 500.\n-   Ensure that all **filter** parameters are valid.\n\n</td></tr><tr><td>\n\n404\n\n</td><td id=\"entry-404-status-code\">\n\nNot found. The requested item wasn't found.\n\n</td></tr></tbody>\n</table>### Response body parameters \\(JSON\\)\n\n<table id=\"id_x11_hyj_grb\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr id=\"user_active-SCIM-row\"><td>\n\nactive\n\n</td><td id=\"user_active-SCIM-entry\">\n\nFlag that indicates whether the associated user is active within the ServiceNow instance.Possible values:\n\n-   true: User is active.\n-   false: User is inactive.\n\nData type: Boolean\n\n</td></tr><tr id=\"user_addresses-SCIM-row\"><td>\n\naddresses\n\n</td><td id=\"user_addresses-SCIM-entry\">\n\nDetails of the user's current mailing address.Data type: Object\n\n```\n\"addresses\": {\n  \"country\": \"String\",\n  \"locality\": \"String\",\n  \"postalCode\": \"String\",\n  \"region\": \"String\",\n  \"streetAddress\": \"String\",\n  \"type\": \"String\"\n}\n```\n\n</td></tr><tr id=\"user_addresses_country-SCIM-row\"><td>\n\naddresses.country\n\n</td><td id=\"user_addresses_country-SCIM-entry\">\n\nCountry name.Data type: String\n\n</td></tr><tr id=\"user_addresses_locality-SCIM-row\"><td>\n\naddresses.locality\n\n</td><td id=\"user_addresses_locality-SCIM-entry\">\n\nCity or locality name.Data type: String\n\n</td></tr><tr id=\"user_addresses_postalCode-SCIM-row\"><td>\n\naddresses.postalCode\n\n</td><td id=\"user_addresses_postalCode-SCIM-entry\">\n\nZip or postal code.Data type: String\n\n</td></tr><tr id=\"user_addresses_region-SCIM-row\"><td>\n\naddresses.region\n\n</td><td id=\"user_addresses_region-SCIM-entry\">\n\nState or region.Data type: String\n\n</td></tr><tr id=\"user_addresses_streetAddress-SCIM-row\"><td>\n\naddresses.streetAddress\n\n</td><td id=\"user_addresses_streetAddress-SCIM-entry\">\n\nFull street address. This can include the house number, street name, PO Box, and multi-line extended street address information.Data type: String\n\n</td></tr><tr id=\"user_addresses_type-SCIM-row\"><td>\n\naddresses.type\n\n</td><td id=\"user_addresses_type-SCIM-entry\">\n\nType of address. Currently only supports `home`.Data type: String\n\n</td></tr><tr id=\"user_displayName-SCIM-row\"><td>\n\ndisplayName\n\n</td><td id=\"user_displayName-SCIM-entry\">\n\nUser display name. This value is auto-generated by concatenating the **name** fields. Data type: String\n\n</td></tr><tr id=\"user_emails-SCIM-row\"><td>\n\nemails\n\n</td><td id=\"user_emails-SCIM-entry\">\n\nList of email accounts associated with the user.Data type: Array of Objects\n\n```\n\"emails:\" [\n  {\n    \"type\": \"String\",\n    \"value\": \"String\"\n  }\n]\n```\n\n</td></tr><tr id=\"user_emails_type-SCIM-row\"><td>\n\nemails.type\n\n</td><td id=\"user_emails_type-SCIM-entry\">\n\nUser email type. Currently only supports type of \"work\".Data type: String\n\n</td></tr><tr id=\"user_emails_value-SCIM-row\"><td>\n\nemails.value\n\n</td><td id=\"user_emails_value-SCIM-entry\">\n\nUser's email address. This is a unique key for the associated user.Data type: String\n\n</td></tr><tr id=\"user_emails_externalId-SCIM-row\"><td>\n\nexternalId\n\n</td><td id=\"user_emails_externalId-SCIM-entry\">\n\nUnique identifier assigned to the user by the entity provisioning it.Data type: String\n\n</td></tr><tr id=\"user_groups-SCIM-row\"><td>\n\ngroups\n\n</td><td id=\"user_groups-SCIM-entry\">\n\nList of groups to which the user belongs, either through direct membership, nested groups, or dynamically calculated.Data type: Array of Objects\n\n```\n\"groups\": [\n  {\n    \"display\": \"String\",\n    \"type\": \"String\",\n    \"value\": \"String\",\n    \"$ref\": \"String\"\n  }\n]\n```\n\n</td></tr><tr id=\"user_groups_display-SCIM-row\"><td>\n\ngroups.display\n\n</td><td id=\"user_groups_display-SCIM-entry\">\n\nName of the associated group.Data type: String\n\n</td></tr><tr id=\"user_groups_type-SCIM-row\"><td>\n\ngroups.type\n\n</td><td id=\"user_groups_type-SCIM-entry\">\n\nType of group association, such as direct or indirect.Data type: String\n\n</td></tr><tr id=\"user_groups_value-SCIM-row\"><td>\n\ngroups.value\n\n</td><td id=\"user_groups_value-SCIM-entry\">\n\nSys\\_id of an associated group record.Data type: String\n\n</td></tr><tr id=\"user_groups_ref-SCIM-row\"><td>\n\ngroups.$ref\n\n</td><td id=\"user_groups_ref-SCIM-entry\">\n\nURI of the associated group.Data type: String\n\n</td></tr><tr id=\"user_id-SCIM-row\"><td>\n\nid\n\n</td><td id=\"user_id-SCIM-entry\">\n\nSys\\_id of the associated User record.Data type: String\n\n</td></tr><tr id=\"user_meta-SCIM-row\"><td>\n\nmeta\n\n</td><td id=\"user_meta-SCIM-entry\">\n\nMetadata pertaining to the user.Data type: Object\n\n```\n\"meta\": {\n  \"created\": \"String\",\n  \"lastModified\": \"String\",\n  \"location\": String\",\n  \"resourceType\": String\"\n}\n```\n\n</td></tr><tr id=\"user_meta_created-SCIM-row\"><td>\n\nmeta.created\n\n</td><td id=\"user_meta_created-SCIM-entry\">\n\nDate and time when the user record was created.Data type: String\n\n</td></tr><tr id=\"user_meta_lastModified-SCIM-row\"><td>\n\nmeta.lastModified\n\n</td><td id=\"user_meta_lastModified-SCIM-entry\">\n\nDate and time when the user record was last modified.Data type: String\n\n</td></tr><tr id=\"user_meta_location-SCIM-row\"><td>\n\nmeta.location\n\n</td><td id=\"user_meta_location-SCIM-entry\">\n\nURI of the user being retrieved.Data type: String\n\n</td></tr><tr id=\"user_meta_resourceType-SCIM-row\"><td>\n\nmeta.resourceType\n\n</td><td id=\"user_meta_resourceType-SCIM-entry\">\n\nSCIM Users' resource type.Data type: String\n\n</td></tr><tr id=\"user_name-SCIM-row\"><td>\n\nname\n\n</td><td id=\"user_name-SCIM-entry\">\n\nUser's name information.Data type: Object\n\n```\n\"name\": {\n  \"familyName\": \"String\",\n  \"givenName\": \"String\",\n  \"honorificPrefix\": \"String\",\n  \"middleName\": \"String\"\n}\n```\n\n</td></tr><tr id=\"user_name_familyName-SCIM-row\"><td>\n\nname.familyName\n\n</td><td id=\"user_name_familyName-SCIM-entry\">\n\nUser's family or last name.Data type: String\n\n</td></tr><tr id=\"user_name_givenName-SCIM-row\"><td>\n\nname.givenName\n\n</td><td id=\"user_name_givenName-SCIM-entry\">\n\nUser's given or first name.Data type: String\n\n</td></tr><tr id=\"user_name_honorificPrefix-SCIM-row\"><td>\n\nname.honorificPrefix\n\n</td><td id=\"user_name_honorificPrefix-SCIM-entry\">\n\nUser's honorific name or title, such as Dr., Bishop, or Baron.Data type: String\n\n</td></tr><tr id=\"user_name_middle-SCIM-row\"><td>\n\nname.middle\n\n</td><td id=\"user_name_middle-SCIM-entry\">\n\nUser's middle name.Data type: String\n\n</td></tr><tr id=\"user_phoneNumbers-SCIM-row\"><td>\n\nphoneNumbers\n\n</td><td id=\"user_phoneNumbers-SCIM-entry\">\n\nList of phone numbers associated with the user.Data type: Array of Objects\n\n```\n\"phoneNumbers\": [\n  {\n    \"type\": \"String\",\n    \"value\": \"String\"\n  }\n]\n```\n\n</td></tr><tr id=\"user_phoneNumbers_type-SCIM-row\"><td>\n\nphoneNumbers.type\n\n</td><td id=\"user_phoneNumbers_type-SCIM-entry\">\n\nType of phone number.Possible values:\n\n-   home\n-   mobile\n-   work\n\nData type: String\n\n</td></tr><tr id=\"user_phoneNumbers_value-SCIM-row\"><td>\n\nphoneNumbers.value\n\n</td><td id=\"user_phoneNumbers_value-SCIM-entry\">\n\nUser's phone number.Data type: String\n\n</td></tr><tr id=\"user_preferredLanguage-SCIM-row\"><td>\n\npreferredLanguage\n\n</td><td id=\"user_preferredLanguage-SCIM-entry\">\n\nUser's preferred spoken and written language.Data type: String\n\n</td></tr><tr id=\"user_schemas-SCIM-row\"><td>\n\nschemas\n\n</td><td id=\"user_schemas-SCIM-entry\">\n\nList of URIs of the SCIM User schemas used to process the request.Data type: Array of Strings\n\n</td></tr><tr id=\"user_timezone-SCIM-row\"><td>\n\ntimezone\n\n</td><td id=\"user_timezone-SCIM-entry\">\n\nUser's time zone.Data type: String\n\n</td></tr><tr id=\"user_title-SCIM-row\"><td>\n\ntitle\n\n</td><td id=\"user_title-SCIM-entry\">\n\nUser's title, such as CEO or President.Data type: String\n\n</td></tr><tr id=\"user_userName-SCIM-row\"><td>\n\nuserName\n\n</td><td id=\"user_userName-SCIM-entry\">\n\nUnique user name for the associated user. Data type: String\n\n</td></tr><tr id=\"user_userType-SCIM-row\"><td>\n\nuserType\n\n</td><td id=\"user_userType-SCIM-entry\">\n\nUser type. This value is used to identify the organization to user relationship.This can be any value, but typical values might include:\n\n-   Contractor\n-   Employee\n-   Intern\n-   Temp\n-   External\n-   Unknown\n\nData type: String\n\n</td></tr></tbody>\n</table>### Extension parameters returned\n\n<table id=\"id_hmw_fjk_grb\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr id=\"user_company-SCIM-row\"><td>\n\ncompany\n\n</td><td id=\"user_company-SCIM-entry\">\n\nDetails about the user's associated company.Data type: Object\n\n```\n\"company\": {\n  \"display\": \"String\",\n  \"value\": \"String\",\n  \"$ref\": \"String\"\n}\n```\n\n</td></tr><tr id=\"user_company_display-SCIM-row\"><td>\n\ncompany.display\n\n</td><td id=\"user_company_display-SCIM-entry\">\n\nName of the company.Data type: String\n\n</td></tr><tr id=\"user_company_value-SCIM-row\"><td>\n\ncompany.value\n\n</td><td id=\"user_company_value-SCIM-entry\">\n\nSys\\_id of the company record.Data type: String\n\n</td></tr><tr id=\"user_company_ref-SCIM-row\"><td>\n\ncompany.$ref\n\n</td><td id=\"user_company_ref-SCIM-entry\">\n\nReference URI for the company.Data type: String\n\n</td></tr><tr id=\"user_costCenter-SCIM-row\"><td>\n\ncostCenter\n\n</td><td id=\"user_costCenter-SCIM-entry\">\n\nDetails about the user's associated cost center.Data type: Object\n\n```\n\"costCenter\": {\n  \"display\": \"String\",\n  \"value\": \"String\",\n  \"$ref\": \"String\"\n}\n```\n\n</td></tr><tr id=\"user_costCenter_display-SCIM-row\"><td>\n\ncostCenter.display\n\n</td><td id=\"user_costCenter_display-SCIM-entry\">\n\nName of the cost center.Data type: String\n\n</td></tr><tr id=\"user_costCenter_value-SCIM-row\"><td>\n\ncostCenter.value\n\n</td><td id=\"user_costCenter_value-SCIM-entry\">\n\nSys\\_id of the cost center record. Data type: String\n\n</td></tr><tr id=\"user_costCenter_ref-SCIM-row\"><td>\n\ncostCenter.$ref\n\n</td><td id=\"user_costCenter_ref-SCIM-entry\">\n\nReference URI for the cost center.Data type: String\n\n</td></tr><tr id=\"user_department-SCIM-row\"><td>\n\ndepartment\n\n</td><td id=\"user_department-SCIM-entry\">\n\nDetails about the user's associated department.Data type: Object\n\n```\n\"department\": {\n  \"display\": \"String\",\n  \"value\": \"String\",\n  \"$ref\": \"String\"\n}\n```\n\n</td></tr><tr id=\"user_department_display-SCIM-row\"><td>\n\ndepartment.display\n\n</td><td id=\"user_department_display-SCIM-entry\">\n\nName of the department.Data type: String\n\n</td></tr><tr id=\"user_department_value-SCIM-row\"><td>\n\ndepartment.value\n\n</td><td id=\"user_department_value-SCIM-entry\">\n\nSys\\_id of the department record. Data type: String\n\n</td></tr><tr id=\"user_department_ref-SCIM-row\"><td>\n\ndepartment.$ref\n\n</td><td id=\"user_department_ref-SCIM-entry\">\n\nReference URI for the department.Data type: String\n\n</td></tr><tr id=\"user_employeeNumber-SCIM-row\"><td>\n\nemployeeNumber\n\n</td><td id=\"user_employeeNumber-SCIM-entry\">\n\nNumeric or alphanumeric employee number.Data type: String\n\n</td></tr><tr id=\"user_gender-SCIM-row\"><td>\n\ngender\n\n</td><td id=\"user_gender-SCIM-entry\">\n\nGender of the user, such as male or female.Data type: String\n\n</td></tr><tr id=\"user_location-SCIM-row\"><td>\n\nlocation\n\n</td><td id=\"user_location-SCIM-entry\">\n\nDetails about the user's associated location.Data type: Object\n\n```\n\"location\": {\n  \"display\": \"String\",\n  \"value\": \"String\",\n  \"$ref\": \"String\"\n}\n```\n\n</td></tr><tr id=\"user_location_display-SCIM-row\"><td>\n\nlocation.display\n\n</td><td id=\"user_location_display-SCIM-entry\">\n\nName of the location.Data type: String\n\n</td></tr><tr id=\"user_location_value-SCIM-row\"><td>\n\nlocation.value\n\n</td><td id=\"user_location_value-SCIM-entry\">\n\nSys\\_id of the location record. Data type: String\n\n</td></tr><tr id=\"user_location_ref-SCIM-row\"><td>\n\nlocation.$ref\n\n</td><td id=\"user_location_ref-SCIM-entry\">\n\nReference URI for the location.Data type: String\n\n</td></tr><tr id=\"user_manager-SCIM-row\"><td>\n\nmanager\n\n</td><td id=\"user_manager-SCIM-entry\">\n\nDetails about the user's associated manager.Data type: Object\n\n```\n\"manager\": {\n  \"display\": \"String\",\n  \"value\": \"String\",\n  \"$ref\": \"String\"\n}\n```\n\n</td></tr><tr id=\"user_manager_display-SCIM-row\"><td>\n\nmanager.display\n\n</td><td id=\"user_manager_display-SCIM-entry\">\n\nName of the manager.Data type: String\n\n</td></tr><tr id=\"user_manager_value-SCIM-row\"><td>\n\nmanager.value\n\n</td><td id=\"user_manager_value-SCIM-entry\">\n\nSys\\_id of the manager record. Data type: String\n\n</td></tr><tr id=\"user_manager_ref-SCIM-row\"><td>\n\nmanager.$ref\n\n</td><td id=\"user_manager_ref-SCIM-entry\">\n\nReference URI for the manager.Data type: String\n\n</td></tr></tbody>\n</table>### cURL request using user sys\\_id\n\nThe following example shows how to obtain a specific user record by passing their sys\\_id.\n\n```\ncurl \"https://instance-servicenow.com/api/now/scim/Users/62826bf03710200044e0bfc8bcbe5df1\" \\\n--request GET \\\n--header \"Accept:application/scim+json\" \\\n```\n\nResponse:\n\n```\n{\"schemas\":\n  [\n    \"urn:ietf:params:scim:schemas:extension:servicenow:2.0:User\",\n    \"urn:ietf:params:scim:schemas:core:2.0:User\"\n  ],\n    \"id\":\"62826bf03710200044e0bfc8bcbe5df1\",\n    \"meta\":\n      {\n        \"resourceType\":\"User\",\n        \"created\":\"2012-02-18T03:04:52Z\",\n        \"lastModified\":\"2021-10-01T14:23:34Z\",\n        \"location\":\"https://instance-servicenow.com/api/now/scim/Users/62826bf03710200044e0bfc8bcbe5df1\"\n      },\n    \"userName\":\"abel.tuter\",\n    \"name\":\n      {\n        \"familyName\":\"Tuter\",\n        \"givenName\":\"Abel\"\n      },\n    \"displayName\":\"Abel Tuter\",\n    \"active\":true,\n    \"emails\":[\n      {\n        \"value\":\"abel.tuter@example.com\",\n        \"type\":\"work\"\n      }\n    ],\n    \"urn:ietf:params:scim:schemas:extension:servicenow:2.0:User\":\n      {\n        \"gender\":\"Male\",\n        \"costCenter\":\n          {\n            \"value\":\"d9d07bddc0a80a647cf932056ed24652\",\n            \"name\":\"Engineering\"\n          },\n        \"company\":\n          {\n            \"value\":\"227cdfb03710200044e0bfc8bcbe5d6b\",\n            \"name\":\"ACME South America\"\n          },\n        \"department\":\n          {\n            \"value\":\"9a7ed3f03710200044e0bfc8bcbe5db7\",\n            \"name\":\"Product Management\"\n           },\n        \"location\":\n          {\n            \"value\":\"25b3d04b0a0a0bb300176b546c22db27\",\n            \"name\":\"SHS quadra 5, Bloco E., Brasilia\"}\n          }\n      }\n\n```\n\n## SCIM - PATCH /scim/Users/\\{user\\_id\\}\n\nEnables you to add, replace, and remove specified fields in a user record in the User \\[sys\\_user\\] table of a ServiceNow instance using the System for Cross-domain Identity Management \\(SCIM\\) protocol.\n\n### URL format\n\nVersioned URL: `/api/now/{api_version}/scim/Users/{user_id}`\n\nDefault URL: `/api/now/scim/Users/{user_id}`\n\n**Note:** Available versions are specified in the [REST API Explorer](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/use-REST-API-Explorer.md). For scripted REST APIs there is additional version information on the [Scripted REST Service form](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_CustomWebServices.md).\n\n### Supported request parameters\n\n<table class=\"rest_api_path_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\napi\\_version\n\n</td><td id=\"version-entry-RESTAPI\">\n\nOptional. Version of the endpoint to access. For example, `v1` or `v2`. Only specify this value to use an endpoint version other than the latest. Data type: String\n\n</td></tr><tr><td>\n\nuser\\_id\n\n</td><td>\n\nSys\\_id of the user record to modify.Data type: String\n\nTable: User \\[sys\\_user\\]\n\n</td></tr></tbody>\n</table><table class=\"rest_api_query_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nattributes\n\n</td><td id=\"attributes-SCIM-entry\">\n\nComma-separated list of fields to return in the response. No other fields are returned.Can't be used with the **excludedAttributes** parameter.\n\nData type: String\n\nDefault: Return all fields unless **excludedAttributes** is specified.\n\n</td></tr><tr><td>\n\nexcludedAttributes\n\n</td><td id=\"excludedAttributes-SCIM-entry\">\n\nComma-separated list of fields to exclude from the records returned in the response. All other fields are returned.Can't be used with the **attributes** parameter.\n\nData type: String\n\nDefault: Do not exclude any fields.\n\n</td></tr></tbody>\n</table><table class=\"rest_api_request_body\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nOperations\n\n</td><td>\n\nRequired. List of operation objects to patch the specified user record with.Data type: Array\n\n ```\n\"Operations\": [\n  {\n    \"op\": \"String\",\n    \"path\": \"String\",\n    \"value\": Any\n  }\n]\n```\n\n</td></tr><tr><td>\n\nOperations.op\n\n</td><td>\n\nRequired. Operation to perform.Valid values:\n\n-   add: Add the specified field and value to the user record.\n-   remove: Remove the value from the specified field.\n-   replace: Replace the value of the specified field.\n\n Data type: String\n\n</td></tr><tr><td>\n\nOperations.path\n\n</td><td>\n\nRequired for `remove` operations. Name/path of the field to modify.The **path** parameter can have one of the following formats:\n\n-   A direct field, such as `title`\n-   A nested fields, such as `name.givenName`\n-   In case of complex array, it can point to a specific element with a filter, such as: `emails[type eq \"work\"]`\n\n```\n{\n  \"schemas\": [\n    \"urn:ietf:params:scim:api:messages:2.0:PatchOp\"\n  ],\n  \"Operations\": [\n    {\n      \"op\": \"add\",\n      \"path\": \"title\",\n      \"value\": \"xyz\"\n    },\n    {  \n      \"op\": \"replace\",\n      \"path\": \"name.givenName\",\n      \"value\": \"Jennifer\"\n    },\n    {\n      \"op\": \"replace\",\n      \"path\": \"emails[type eq \\\"work\\\"]\",\n      \"value\": \"xyz@test.com\"\n    }\n  ]\n}\n```\n\n Data type: String\n\n Default: Considers the field to be a user resource.\n\n</td></tr><tr><td>\n\nOperations.value\n\n</td><td>\n\nValue of the field specified in the **Operations.path** parameter. The format of this parameter depends on the data-type of the associated field. For example, if updating a simple string, such as the title, the **value** field is expressed as a string.\n\n ```\n \"Operations\": [\n  {\n    \"op\": \"add\",\n    \"path\": \"title\",\n    \"value\": \"xyz\"\n  }\n]\n```\n\n You can also declare simple string values without using **value** or **path** parameters, such as:\n\n```\n \"Operations\": [\n  {\n    \"op\": \"add\",\n    \"title\": \"xyz\"\n  }\n]\n```\n\n However, when updating a phone number, which is an array that contains objects that define additional fields to add to the user record and their associated values, the **value** field is expressed as an array of objects.\n\n ```\n \"Operations\": [\n  {\n    \"op\": \"add\",\n    \"path\": \"phoneNumbers\",\n    \"value\": [\n      {\n        \"type\": \"work\",\n        \"value\": \"9876543210\"\n      },\n      {\n        \"type\": \"home\",\n        \"value\": \"9876783216\"\n      }\n    ]\n  }\n]\n```\n\n When specifying attribute nodes, the entry can include the nesting as follows:\n\n```\n{\n  \"op\": \"replace\",\n  \"value\": {\n    \"name\": {\n      \"familyName\": \"Jones\",\n      \"givenName\": \"Jennifer\"\n    }\n  }\n}\n```\n\nOr you can specify the nesting in the **Operations.path**:\n\n ```\n{\n  \"op\": \"replace\",\n  \"path\": \"name.givenName\",\n  \"value\": \"Jennifer\"\n}\n```\n\n If the field being updated is not in the base-schema, you must enclose the name-value pair in an object that specifies the URN of the associated schema.\n\n ```\n\"value\": {\n  \"<schema_urn>\": {\n    \"<field_name>\": \"<new_value>\"\n  },\n}\n```\n\n For example:\n\n ```\n\"value\": {\n  \"urn:ietf:params:scim:schemas:extension:servicenow:2.0:User\": {\n    \"employeeNumber\": \"13454\"\n  },\n}\n```\n\nData type: Any\n\n</td></tr><tr><td>\n\nOperations.value.type\n\n</td><td>\n\nName of the field to update.Data type: String\n\n</td></tr><tr><td>\n\nOperations.value.value\n\n</td><td>\n\nValue to update the field with. Data type: String\n\n</td></tr><tr><td>\n\nschemas\n\n</td><td>\n\nRequired. SCIM Schema URI of Patch Operation `urn:ietf:params:scim:api:messages:2.0:PatchOp`.Data type: String\n\n</td></tr></tbody>\n</table>### Headers\n\nThe following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table class=\"rest_api_request_headers\"><thead><tr><th>\n\nHeader\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nAccept\n\n</td><td id=\"Accept-SCIM-entry\">\n\nData format of the response body. Supported types: **application/json** or **application/scim+json**.Default: **application/json**\n\n</td></tr><tr><td>\n\nContent-Type\n\n</td><td id=\"Content_Type-SCIM-entry\">\n\nData format of the request body. Supported types: **application/json** or **application/scim+json**.Default: **application/json**\n\n</td></tr></tbody>\n</table>|Header|Description|\n|------|-----------|\n|None| |\n\n### Status codes\n\nThe following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table><thead><tr><th>\n\nStatus code\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\n200\n\n</td><td id=\"entry-200-status-code\">\n\nSuccessful. The request was successfully processed.\n\n</td></tr><tr><td>\n\n400\n\n</td><td>\n\nBad Request. A bad request type or malformed request was detected.-   Check for invalid values:\n    -   Malformed request body.\n    -   Required field is not provided or empty.\n    -   Invalid user or group sys\\_id is provided.\n-   Check if a read-only or immutable field is trying to be modified.\n-   Ensure that both the **attributes** and **excludedAttributes** query parameters have not been passed in the request or that the request does not exceed the maximum number of members.\n\n</td></tr><tr><td>\n\n404\n\n</td><td id=\"entry-404-status-code\">\n\nNot found. The requested item wasn't found.\n\n</td></tr><tr><td>\n\n409\n\n</td><td>\n\nUser already exists. The **userName** parameter must be unique.\n\n</td></tr><tr><td>\n\n500\n\n</td><td id=\"entry-500-status-code\">\n\nInternal server error. An unexpected error occurred while processing the request. The response contains additional information about the error.\n\n</td></tr></tbody>\n</table>### Response body parameters \\(JSON\\)\n\n<table id=\"table_mjy_k1l_grb\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nactive\n\n</td><td id=\"user_active-SCIM-entry\">\n\nFlag that indicates whether the associated user is active within the ServiceNow instance.Possible values:\n\n-   true: User is active.\n-   false: User is inactive.\n\nData type: Boolean\n\n</td></tr><tr><td>\n\naddresses\n\n</td><td id=\"user_addresses-SCIM-entry\">\n\nDetails of the user's current mailing address.Data type: Object\n\n```\n\"addresses\": {\n  \"country\": \"String\",\n  \"locality\": \"String\",\n  \"postalCode\": \"String\",\n  \"region\": \"String\",\n  \"streetAddress\": \"String\",\n  \"type\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\naddresses.country\n\n</td><td id=\"user_addresses_country-SCIM-entry\">\n\nCountry name.Data type: String\n\n</td></tr><tr><td>\n\naddresses.locality\n\n</td><td id=\"user_addresses_locality-SCIM-entry\">\n\nCity or locality name.Data type: String\n\n</td></tr><tr><td>\n\naddresses.postalCode\n\n</td><td id=\"user_addresses_postalCode-SCIM-entry\">\n\nZip or postal code.Data type: String\n\n</td></tr><tr><td>\n\naddresses.region\n\n</td><td id=\"user_addresses_region-SCIM-entry\">\n\nState or region.Data type: String\n\n</td></tr><tr><td>\n\naddresses.streetAddress\n\n</td><td id=\"user_addresses_streetAddress-SCIM-entry\">\n\nFull street address. This can include the house number, street name, PO Box, and multi-line extended street address information.Data type: String\n\n</td></tr><tr><td>\n\naddresses.type\n\n</td><td id=\"user_addresses_type-SCIM-entry\">\n\nType of address. Currently only supports `home`.Data type: String\n\n</td></tr><tr><td>\n\ndisplayName\n\n</td><td id=\"user_displayName-SCIM-entry\">\n\nUser display name. This value is auto-generated by concatenating the **name** fields. Data type: String\n\n</td></tr><tr><td>\n\nemails\n\n</td><td id=\"user_emails-SCIM-entry\">\n\nList of email accounts associated with the user.Data type: Array of Objects\n\n```\n\"emails:\" [\n  {\n    \"type\": \"String\",\n    \"value\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nemails.type\n\n</td><td id=\"user_emails_type-SCIM-entry\">\n\nUser email type. Currently only supports type of \"work\".Data type: String\n\n</td></tr><tr><td>\n\nemails.value\n\n</td><td id=\"user_emails_value-SCIM-entry\">\n\nUser's email address. This is a unique key for the associated user.Data type: String\n\n</td></tr><tr><td>\n\nerrors\n\n</td><td id=\"errors-SCIM-entry\">\n\nResponse that describes any errors that may have occurred during processing the request.Data type: Object\n\n```\n\"errors\": {\n  \"details\": \"String\",\n  \"schemas\": \"String\",\n  \"scimType\": \"String\",\n  \"status\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nerrors.detail\n\n</td><td id=\"errors_details-SCIM-entry\">\n\nDetailed error message on why the request failed.Data type: String\n\n</td></tr><tr><td>\n\nerrors.scimType\n\n</td><td id=\"errors_scimType-SCIM-entry\">\n\nSCIM error detail keyword.Data type: String\n\n</td></tr><tr><td>\n\nerrors.schemas\n\n</td><td id=\"errors_schemas-SCIM-entry\">\n\nURI of the SCIM Schemas used to process the error response.Data type: Array of Strings\n\n</td></tr><tr><td>\n\nerrors.status\n\n</td><td id=\"errors_status-SCIM-entry\">\n\nHTTP status code for the error response.Data type: String\n\n</td></tr><tr><td>\n\nexternalId\n\n</td><td id=\"user_emails_externalId-SCIM-entry\">\n\nUnique identifier assigned to the user by the entity provisioning it.Data type: String\n\n</td></tr><tr><td>\n\ngroups\n\n</td><td id=\"user_groups-SCIM-entry\">\n\nList of groups to which the user belongs, either through direct membership, nested groups, or dynamically calculated.Data type: Array of Objects\n\n```\n\"groups\": [\n  {\n    \"display\": \"String\",\n    \"type\": \"String\",\n    \"value\": \"String\",\n    \"$ref\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\ngroups.display\n\n</td><td id=\"user_groups_display-SCIM-entry\">\n\nName of the associated group.Data type: String\n\n</td></tr><tr><td>\n\ngroups.type\n\n</td><td id=\"user_groups_type-SCIM-entry\">\n\nType of group association, such as direct or indirect.Data type: String\n\n</td></tr><tr><td>\n\ngroups.value\n\n</td><td id=\"user_groups_value-SCIM-entry\">\n\nSys\\_id of an associated group record.Data type: String\n\n</td></tr><tr><td>\n\ngroups.$ref\n\n</td><td id=\"user_groups_ref-SCIM-entry\">\n\nURI of the associated group.Data type: String\n\n</td></tr><tr><td>\n\nid\n\n</td><td id=\"user_id-SCIM-entry\">\n\nSys\\_id of the associated User record.Data type: String\n\n</td></tr><tr><td>\n\nmeta\n\n</td><td id=\"user_meta-SCIM-entry\">\n\nMetadata pertaining to the user.Data type: Object\n\n```\n\"meta\": {\n  \"created\": \"String\",\n  \"lastModified\": \"String\",\n  \"location\": String\",\n  \"resourceType\": String\"\n}\n```\n\n</td></tr><tr><td>\n\nmeta.created\n\n</td><td id=\"user_meta_created-SCIM-entry\">\n\nDate and time when the user record was created.Data type: String\n\n</td></tr><tr><td>\n\nmeta.lastModified\n\n</td><td id=\"user_meta_lastModified-SCIM-entry\">\n\nDate and time when the user record was last modified.Data type: String\n\n</td></tr><tr><td>\n\nmeta.location\n\n</td><td id=\"user_meta_location-SCIM-entry\">\n\nURI of the user being retrieved.Data type: String\n\n</td></tr><tr><td>\n\nmeta.resourceType\n\n</td><td id=\"user_meta_resourceType-SCIM-entry\">\n\nSCIM Users' resource type.Data type: String\n\n</td></tr><tr><td>\n\nname\n\n</td><td id=\"user_name-SCIM-entry\">\n\nUser's name information.Data type: Object\n\n```\n\"name\": {\n  \"familyName\": \"String\",\n  \"givenName\": \"String\",\n  \"honorificPrefix\": \"String\",\n  \"middleName\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nname.familyName\n\n</td><td id=\"user_name_familyName-SCIM-entry\">\n\nUser's family or last name.Data type: String\n\n</td></tr><tr><td>\n\nname.givenName\n\n</td><td id=\"user_name_givenName-SCIM-entry\">\n\nUser's given or first name.Data type: String\n\n</td></tr><tr><td>\n\nname.honorificPrefix\n\n</td><td id=\"user_name_honorificPrefix-SCIM-entry\">\n\nUser's honorific name or title, such as Dr., Bishop, or Baron.Data type: String\n\n</td></tr><tr><td>\n\nname.middle\n\n</td><td id=\"user_name_middle-SCIM-entry\">\n\nUser's middle name.Data type: String\n\n</td></tr><tr><td>\n\nphoneNumbers\n\n</td><td id=\"user_phoneNumbers-SCIM-entry\">\n\nList of phone numbers associated with the user.Data type: Array of Objects\n\n```\n\"phoneNumbers\": [\n  {\n    \"type\": \"String\",\n    \"value\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nphoneNumbers.type\n\n</td><td id=\"user_phoneNumbers_type-SCIM-entry\">\n\nType of phone number.Possible values:\n\n-   home\n-   mobile\n-   work\n\nData type: String\n\n</td></tr><tr><td>\n\nphoneNumbers.value\n\n</td><td id=\"user_phoneNumbers_value-SCIM-entry\">\n\nUser's phone number.Data type: String\n\n</td></tr><tr><td>\n\npreferredLanguage\n\n</td><td id=\"user_preferredLanguage-SCIM-entry\">\n\nUser's preferred spoken and written language.Data type: String\n\n</td></tr><tr><td>\n\nschemas\n\n</td><td id=\"user_schemas-SCIM-entry\">\n\nList of URIs of the SCIM User schemas used to process the request.Data type: Array of Strings\n\n</td></tr><tr><td>\n\ntimezone\n\n</td><td id=\"user_timezone-SCIM-entry\">\n\nUser's time zone.Data type: String\n\n</td></tr><tr><td>\n\ntitle\n\n</td><td id=\"user_title-SCIM-entry\">\n\nUser's title, such as CEO or President.Data type: String\n\n</td></tr><tr><td>\n\nuserName\n\n</td><td id=\"user_userName-SCIM-entry\">\n\nUnique user name for the associated user. Data type: String\n\n</td></tr><tr><td>\n\nuserType\n\n</td><td id=\"user_userType-SCIM-entry\">\n\nUser type. This value is used to identify the organization to user relationship.This can be any value, but typical values might include:\n\n-   Contractor\n-   Employee\n-   Intern\n-   Temp\n-   External\n-   Unknown\n\nData type: String\n\n</td></tr></tbody>\n</table>### Extension parameters returned\n\n<table id=\"id_hmw_fjk_grb\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr id=\"user_company-SCIM-row\"><td>\n\ncompany\n\n</td><td id=\"user_company-SCIM-entry\">\n\nDetails about the user's associated company.Data type: Object\n\n```\n\"company\": {\n  \"display\": \"String\",\n  \"value\": \"String\",\n  \"$ref\": \"String\"\n}\n```\n\n</td></tr><tr id=\"user_company_display-SCIM-row\"><td>\n\ncompany.display\n\n</td><td id=\"user_company_display-SCIM-entry\">\n\nName of the company.Data type: String\n\n</td></tr><tr id=\"user_company_value-SCIM-row\"><td>\n\ncompany.value\n\n</td><td id=\"user_company_value-SCIM-entry\">\n\nSys\\_id of the company record.Data type: String\n\n</td></tr><tr id=\"user_company_ref-SCIM-row\"><td>\n\ncompany.$ref\n\n</td><td id=\"user_company_ref-SCIM-entry\">\n\nReference URI for the company.Data type: String\n\n</td></tr><tr id=\"user_costCenter-SCIM-row\"><td>\n\ncostCenter\n\n</td><td id=\"user_costCenter-SCIM-entry\">\n\nDetails about the user's associated cost center.Data type: Object\n\n```\n\"costCenter\": {\n  \"display\": \"String\",\n  \"value\": \"String\",\n  \"$ref\": \"String\"\n}\n```\n\n</td></tr><tr id=\"user_costCenter_display-SCIM-row\"><td>\n\ncostCenter.display\n\n</td><td id=\"user_costCenter_display-SCIM-entry\">\n\nName of the cost center.Data type: String\n\n</td></tr><tr id=\"user_costCenter_value-SCIM-row\"><td>\n\ncostCenter.value\n\n</td><td id=\"user_costCenter_value-SCIM-entry\">\n\nSys\\_id of the cost center record. Data type: String\n\n</td></tr><tr id=\"user_costCenter_ref-SCIM-row\"><td>\n\ncostCenter.$ref\n\n</td><td id=\"user_costCenter_ref-SCIM-entry\">\n\nReference URI for the cost center.Data type: String\n\n</td></tr><tr id=\"user_department-SCIM-row\"><td>\n\ndepartment\n\n</td><td id=\"user_department-SCIM-entry\">\n\nDetails about the user's associated department.Data type: Object\n\n```\n\"department\": {\n  \"display\": \"String\",\n  \"value\": \"String\",\n  \"$ref\": \"String\"\n}\n```\n\n</td></tr><tr id=\"user_department_display-SCIM-row\"><td>\n\ndepartment.display\n\n</td><td id=\"user_department_display-SCIM-entry\">\n\nName of the department.Data type: String\n\n</td></tr><tr id=\"user_department_value-SCIM-row\"><td>\n\ndepartment.value\n\n</td><td id=\"user_department_value-SCIM-entry\">\n\nSys\\_id of the department record. Data type: String\n\n</td></tr><tr id=\"user_department_ref-SCIM-row\"><td>\n\ndepartment.$ref\n\n</td><td id=\"user_department_ref-SCIM-entry\">\n\nReference URI for the department.Data type: String\n\n</td></tr><tr id=\"user_employeeNumber-SCIM-row\"><td>\n\nemployeeNumber\n\n</td><td id=\"user_employeeNumber-SCIM-entry\">\n\nNumeric or alphanumeric employee number.Data type: String\n\n</td></tr><tr id=\"user_gender-SCIM-row\"><td>\n\ngender\n\n</td><td id=\"user_gender-SCIM-entry\">\n\nGender of the user, such as male or female.Data type: String\n\n</td></tr><tr id=\"user_location-SCIM-row\"><td>\n\nlocation\n\n</td><td id=\"user_location-SCIM-entry\">\n\nDetails about the user's associated location.Data type: Object\n\n```\n\"location\": {\n  \"display\": \"String\",\n  \"value\": \"String\",\n  \"$ref\": \"String\"\n}\n```\n\n</td></tr><tr id=\"user_location_display-SCIM-row\"><td>\n\nlocation.display\n\n</td><td id=\"user_location_display-SCIM-entry\">\n\nName of the location.Data type: String\n\n</td></tr><tr id=\"user_location_value-SCIM-row\"><td>\n\nlocation.value\n\n</td><td id=\"user_location_value-SCIM-entry\">\n\nSys\\_id of the location record. Data type: String\n\n</td></tr><tr id=\"user_location_ref-SCIM-row\"><td>\n\nlocation.$ref\n\n</td><td id=\"user_location_ref-SCIM-entry\">\n\nReference URI for the location.Data type: String\n\n</td></tr><tr id=\"user_manager-SCIM-row\"><td>\n\nmanager\n\n</td><td id=\"user_manager-SCIM-entry\">\n\nDetails about the user's associated manager.Data type: Object\n\n```\n\"manager\": {\n  \"display\": \"String\",\n  \"value\": \"String\",\n  \"$ref\": \"String\"\n}\n```\n\n</td></tr><tr id=\"user_manager_display-SCIM-row\"><td>\n\nmanager.display\n\n</td><td id=\"user_manager_display-SCIM-entry\">\n\nName of the manager.Data type: String\n\n</td></tr><tr id=\"user_manager_value-SCIM-row\"><td>\n\nmanager.value\n\n</td><td id=\"user_manager_value-SCIM-entry\">\n\nSys\\_id of the manager record. Data type: String\n\n</td></tr><tr id=\"user_manager_ref-SCIM-row\"><td>\n\nmanager.$ref\n\n</td><td id=\"user_manager_ref-SCIM-entry\">\n\nReference URI for the manager.Data type: String\n\n</td></tr></tbody>\n</table>### cURL request\n\nThe following example shows how to add, remove, and replace values within a user record.\n\n```\ncurl -X PATCH \\\n  https://instance-servicenow.com/api/now/scim/Users/005d500b536073005e0addeeff7b12f4 \\\n  -d '{\n  \"schemas\": [\n    \"urn:ietf:params:scim:api:messages:2.0:PatchOp\"\n  ],\n  \"Operations\": [\n    {\n      \"op\" : \"remove\",\n      \"path\" : \"title\" \n    },\n    {\n      \"op\" : \"add\",\n      \"path\" : \"phoneNumbers\",\n      \"value\" : [\n        {\n          \"type\" : \"work\",\n          \"value\" : \"9876543210\"\n        }\n      ]\n    },\n    {\n      \"op\": \"replace\",\n      \"value\": {\n        \"urn:ietf:params:scim:schemas:extension:servicenow:2.0:User\": {\n            \"employeeNumber\": \"13454\"\n        },\n        \"name\": {\n            \"familyName\": \"John\",\n            \"givenName\": \"Smith\"\n        }\n      }\n    }\n  ]\n}'\n```\n\nResponse:\n\n```\n{\n  \"schemas\":[\n    \"urn:ietf:params:scim:schemas:extension:servicenow:2.0:User\",\n    \"urn:ietf:params:scim:schemas:core:2.0:User\"\n  ],\n  \"id\":\"005d500b536073005e0addeeff7b12f4\",\n  \"meta\":{\n    \"resourceType\":\"User\",\n    \"created\":\"2019-04-05T21:09:12Z\",\n    \"lastModified\":\"2021-10-12T18:29:27Z\",\n    \"location\":\"https://instance-servicenow.com/api/now/scim/Users/005d500b536073005e0addeeff7b12f4\"\n  },\n  \"userName\":\"survey.user\",\n  \"name\":{\n    \"familyName\":\"John\",\n    \"givenName\":\"Smith\"\n  },\n  \"displayName\":\"Smith John\",\n  \"active\":true,\n  \"emails\":[\n    {\n      \"value\":\"survey.user@email.com\",\n      \"type\":\"work\"\n    }\n  ],\n  \"phoneNumbers\":[\n    {\n      \"value\":\"9876543210\",\n      \"type\":\"work\"\n    }\n  ],\n  \"urn:ietf:params:scim:schemas:extension:servicenow:2.0:User\":{\n    \"employeeNumber\":\"13454\"\n  }\n}\n\n```\n\n## SCIM - POST /scim/Users\n\nCreates a user record in the User \\[sys\\_user\\] table of a ServiceNow instance using the System for Cross-domain Identity Management \\(SCIM\\) protocol.\n\n**Note:** The search and bulk modifications functionality as noted in the RFC7643 specification are not supported by this endpoint.\n\n### URL format\n\nVersioned URL: `/api/now/{api_version}/scim/Users`\n\nDefault URL: `/api/now/scim/Users`\n\n**Note:** Available versions are specified in the [REST API Explorer](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/use-REST-API-Explorer.md). For scripted REST APIs there is additional version information on the [Scripted REST Service form](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_CustomWebServices.md).\n\n### Supported request parameters\n\n<table class=\"rest_api_path_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\napi\\_version\n\n</td><td id=\"version-entry-RESTAPI\">\n\nOptional. Version of the endpoint to access. For example, `v1` or `v2`. Only specify this value to use an endpoint version other than the latest. Data type: String\n\n</td></tr></tbody>\n</table><table class=\"rest_api_query_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nattributes\n\n</td><td id=\"attributes-SCIM-entry\">\n\nComma-separated list of fields to return in the response. No other fields are returned.Can't be used with the **excludedAttributes** parameter.\n\nData type: String\n\nDefault: Return all fields unless **excludedAttributes** is specified.\n\n</td></tr><tr><td>\n\nexcludedAttributes\n\n</td><td id=\"excludedAttributes-SCIM-entry\">\n\nComma-separated list of fields to exclude from the records returned in the response. All other fields are returned.Can't be used with the **attributes** parameter.\n\nData type: String\n\nDefault: Do not exclude any fields.\n\n</td></tr></tbody>\n</table><table class=\"rest_api_request_body\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nactive\n\n</td><td id=\"user_active-SCIM-entry\">\n\nFlag that indicates whether the associated user is active within the ServiceNow instance.Possible values:\n\n-   true: User is active.\n-   false: User is inactive.\n\nData type: Boolean\n\n</td></tr><tr><td>\n\naddresses\n\n</td><td id=\"user_addresses-SCIM-entry\">\n\nDetails of the user's current mailing address.Data type: Object\n\n```\n\"addresses\": {\n  \"country\": \"String\",\n  \"locality\": \"String\",\n  \"postalCode\": \"String\",\n  \"region\": \"String\",\n  \"streetAddress\": \"String\",\n  \"type\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\naddresses.country\n\n</td><td id=\"user_addresses_country-SCIM-entry\">\n\nCountry name.Data type: String\n\n</td></tr><tr><td>\n\naddresses.locality\n\n</td><td id=\"user_addresses_locality-SCIM-entry\">\n\nCity or locality name.Data type: String\n\n</td></tr><tr><td>\n\naddresses.postalCode\n\n</td><td id=\"user_addresses_postalCode-SCIM-entry\">\n\nZip or postal code.Data type: String\n\n</td></tr><tr><td>\n\naddresses.region\n\n</td><td id=\"user_addresses_region-SCIM-entry\">\n\nState or region.Data type: String\n\n</td></tr><tr><td>\n\naddresses.streetAddress\n\n</td><td id=\"user_addresses_streetAddress-SCIM-entry\">\n\nFull street address. This can include the house number, street name, PO Box, and multi-line extended street address information.Data type: String\n\n</td></tr><tr><td>\n\naddresses.type\n\n</td><td id=\"user_addresses_type-SCIM-entry\">\n\nType of address. Currently only supports `home`.Data type: String\n\n</td></tr><tr><td>\n\ndisplayName\n\n</td><td id=\"user_displayName-SCIM-entry\">\n\nUser display name. This value is auto-generated by concatenating the **name** fields. Data type: String\n\n</td></tr><tr><td>\n\nemails\n\n</td><td id=\"user_emails-SCIM-entry\">\n\nList of email accounts associated with the user.Data type: Array of Objects\n\n```\n\"emails:\" [\n  {\n    \"type\": \"String\",\n    \"value\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nemails.type\n\n</td><td id=\"user_emails_type-SCIM-entry\">\n\nUser email type. Currently only supports type of \"work\".Data type: String\n\n</td></tr><tr><td>\n\nemails.value\n\n</td><td id=\"user_emails_value-SCIM-entry\">\n\nUser's email address. This is a unique key for the associated user.Data type: String\n\n</td></tr><tr><td>\n\nexternalId\n\n</td><td id=\"user_emails_externalId-SCIM-entry\">\n\nUnique identifier assigned to the user by the entity provisioning it.Data type: String\n\n</td></tr><tr><td>\n\nname\n\n</td><td id=\"user_name-SCIM-entry\">\n\nUser's name information.Data type: Object\n\n```\n\"name\": {\n  \"familyName\": \"String\",\n  \"givenName\": \"String\",\n  \"honorificPrefix\": \"String\",\n  \"middleName\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nname.familyName\n\n</td><td id=\"user_name_familyName-SCIM-entry\">\n\nUser's family or last name.Data type: String\n\n</td></tr><tr><td>\n\nname.givenName\n\n</td><td id=\"user_name_givenName-SCIM-entry\">\n\nUser's given or first name.Data type: String\n\n</td></tr><tr><td>\n\nname.honorificPrefix\n\n</td><td id=\"user_name_honorificPrefix-SCIM-entry\">\n\nUser's honorific name or title, such as Dr., Bishop, or Baron.Data type: String\n\n</td></tr><tr><td>\n\nname.middle\n\n</td><td id=\"user_name_middle-SCIM-entry\">\n\nUser's middle name.Data type: String\n\n</td></tr><tr><td>\n\nphoneNumbers\n\n</td><td id=\"user_phoneNumbers-SCIM-entry\">\n\nList of phone numbers associated with the user.Data type: Array of Objects\n\n```\n\"phoneNumbers\": [\n  {\n    \"type\": \"String\",\n    \"value\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nphoneNumbers.type\n\n</td><td id=\"user_phoneNumbers_type-SCIM-entry\">\n\nType of phone number.Possible values:\n\n-   home\n-   mobile\n-   work\n\nData type: String\n\n</td></tr><tr><td>\n\nphoneNumbers.value\n\n</td><td id=\"user_phoneNumbers_value-SCIM-entry\">\n\nUser's phone number.Data type: String\n\n</td></tr><tr><td>\n\npreferredLanguage\n\n</td><td id=\"user_preferredLanguage-SCIM-entry\">\n\nUser's preferred spoken and written language.Data type: String\n\n</td></tr><tr><td>\n\ntimezone\n\n</td><td id=\"user_timezone-SCIM-entry\">\n\nUser's time zone.Data type: String\n\n</td></tr><tr><td>\n\ntitle\n\n</td><td id=\"user_title-SCIM-entry\">\n\nUser's title, such as CEO or President.Data type: String\n\n</td></tr><tr><td>\n\nuserName\n\n</td><td>\n\nRequired. Unique user name for the associated user. Data type: String\n\n</td></tr><tr><td>\n\nuserType\n\n</td><td id=\"user_userType-SCIM-entry\">\n\nUser type. This value is used to identify the organization to user relationship.This can be any value, but typical values might include:\n\n-   Contractor\n-   Employee\n-   Intern\n-   Temp\n-   External\n-   Unknown\n\nData type: String\n\n</td></tr><tr><td>\n\nExtended Schema\n\n</td><td>\n\n \n\n</td></tr><tr><td>\n\ncompany\n\n</td><td>\n\nDetails about the user's associated company.Data type: Object\n\n```\n\"company\": {\n  \"value\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\ncompany.value\n\n</td><td>\n\nRequired if company is included in post. Sys\\_id of the company record. Data type: String\n\n</td></tr><tr><td>\n\ncostCenter\n\n</td><td>\n\nDetails about the user's associated cost center.Data type: Object\n\n```\n\"costCenter\": {\n  \"value\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\ncostCenter.value\n\n</td><td>\n\nRequired if costCenter is included in post. Sys\\_id of the cost center record. Data type: String\n\n</td></tr><tr><td>\n\ndepartment\n\n</td><td>\n\nDetails about the user's associated department.Data type: Object\n\n```\n\"department\": {\n  \"value\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\ndepartment.value\n\n</td><td>\n\nRequired if department is included in post. Sys\\_id of the department record. Data type: String\n\n</td></tr><tr><td>\n\nemployeeNumber\n\n</td><td id=\"user_employeeNumber-SCIM-entry\">\n\nNumeric or alphanumeric employee number.Data type: String\n\n</td></tr><tr><td>\n\ngender\n\n</td><td id=\"user_gender-SCIM-entry\">\n\nGender of the user, such as male or female.Data type: String\n\n</td></tr><tr><td>\n\nlocation\n\n</td><td>\n\nDetails about the user's associated location.Data type: Object\n\n```\n\"location\": {\n  \"value\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nlocation.value\n\n</td><td>\n\nRequired if location is included in post. Sys\\_id of the location record. Data type: String\n\n</td></tr><tr><td>\n\nmanager\n\n</td><td>\n\nDetails about the user's associated manager.Data type: Object\n\n```\n\"manager\": {\n  \"value\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nmanager.value\n\n</td><td>\n\nRequired if manager is included in post. Sys\\_id of the manager record. Data type: String\n\n</td></tr></tbody>\n</table>### Headers\n\nThe following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table class=\"rest_api_request_headers\"><thead><tr><th>\n\nHeader\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nAccept\n\n</td><td id=\"Accept-SCIM-entry\">\n\nData format of the response body. Supported types: **application/json** or **application/scim+json**.Default: **application/json**\n\n</td></tr><tr><td>\n\nContent-Type\n\n</td><td id=\"Content_Type-SCIM-entry\">\n\nData format of the request body. Supported types: **application/json** or **application/scim+json**.Default: **application/json**\n\n</td></tr></tbody>\n</table>|Header|Description|\n|------|-----------|\n|None| |\n\n### Status codes\n\nThe following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n|Status code|Description|\n|-----------|-----------|\n|201|Successful. The request was successfully processed.|\n|400|Bad Request. A bad request type or malformed request was detected.|\n|409|User already exists. The **userName** parameter must be unique.|\n|500|Internal server error. An unexpected error occurred while processing the request. The response contains additional information about the error.|\n\n### Response body parameters \\(JSON or XML\\)\n\n<table><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nactive\n\n</td><td id=\"d3262e1058\">\n\nFlag that indicates whether the associated user is active within the ServiceNow instance.Possible values:\n\n-   true: User is active.\n-   false: User is inactive.\n\nData type: Boolean\n\n</td></tr><tr><td>\n\naddresses\n\n</td><td id=\"d3262e1082\">\n\nDetails of the user's current mailing address.Data type: Object\n\n```\n\"addresses\": {\n  \"country\": \"String\",\n  \"locality\": \"String\",\n  \"postalCode\": \"String\",\n  \"region\": \"String\",\n  \"streetAddress\": \"String\",\n  \"type\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\naddresses.country\n\n</td><td id=\"d3262e1095\">\n\nCountry name.Data type: String\n\n</td></tr><tr><td>\n\naddresses.locality\n\n</td><td id=\"d3262e1106\">\n\nCity or locality name.Data type: String\n\n</td></tr><tr><td>\n\naddresses.postalCode\n\n</td><td id=\"d3262e1117\">\n\nZip or postal code.Data type: String\n\n</td></tr><tr><td>\n\naddresses.region\n\n</td><td id=\"d3262e1129\">\n\nState or region.Data type: String\n\n</td></tr><tr><td>\n\naddresses.streetAddress\n\n</td><td id=\"d3262e1140\">\n\nFull street address. This can include the house number, street name, PO Box, and multi-line extended street address information.Data type: String\n\n</td></tr><tr><td>\n\naddresses.type\n\n</td><td id=\"d3262e1151\">\n\nType of address. Currently only supports `home`.Data type: String\n\n</td></tr><tr><td>\n\ndisplayName\n\n</td><td id=\"d3262e1165\">\n\nUser display name. This value is auto-generated by concatenating the **name** fields. Data type: String\n\n</td></tr><tr><td>\n\nemails\n\n</td><td id=\"d3262e1179\">\n\nList of email accounts associated with the user.Data type: Array of Objects\n\n```\n\"emails:\" [\n  {\n    \"type\": \"String\",\n    \"value\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nemails.type\n\n</td><td id=\"d3262e1192\">\n\nUser email type. Currently only supports type of \"work\".Data type: String\n\n</td></tr><tr><td>\n\nemails.value\n\n</td><td id=\"d3262e1204\">\n\nUser's email address. This is a unique key for the associated user.Data type: String\n\n</td></tr><tr><td>\n\nerrors\n\n</td><td id=\"errors-SCIM-entry\">\n\nResponse that describes any errors that may have occurred during processing the request.Data type: Object\n\n```\n\"errors\": {\n  \"details\": \"String\",\n  \"schemas\": \"String\",\n  \"scimType\": \"String\",\n  \"status\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nerrors.detail\n\n</td><td id=\"errors_details-SCIM-entry\">\n\nDetailed error message on why the request failed.Data type: String\n\n</td></tr><tr><td>\n\nerrors.scimType\n\n</td><td id=\"errors_scimType-SCIM-entry\">\n\nSCIM error detail keyword.Data type: String\n\n</td></tr><tr><td>\n\nerrors.schemas\n\n</td><td id=\"errors_schemas-SCIM-entry\">\n\nURI of the SCIM Schemas used to process the error response.Data type: Array of Strings\n\n</td></tr><tr><td>\n\nerrors.status\n\n</td><td id=\"errors_status-SCIM-entry\">\n\nHTTP status code for the error response.Data type: String\n\n</td></tr><tr><td>\n\nexternalId\n\n</td><td id=\"d3262e1215\">\n\nUnique identifier assigned to the user by the entity provisioning it.Data type: String\n\n</td></tr><tr><td>\n\ngroups\n\n</td><td id=\"user_groups-SCIM-entry\">\n\nList of groups to which the user belongs, either through direct membership, nested groups, or dynamically calculated.Data type: Array of Objects\n\n```\n\"groups\": [\n  {\n    \"display\": \"String\",\n    \"type\": \"String\",\n    \"value\": \"String\",\n    \"$ref\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\ngroups.display\n\n</td><td id=\"user_groups_display-SCIM-entry\">\n\nName of the associated group.Data type: String\n\n</td></tr><tr><td>\n\ngroups.type\n\n</td><td id=\"user_groups_type-SCIM-entry\">\n\nType of group association, such as direct or indirect.Data type: String\n\n</td></tr><tr><td>\n\ngroups.value\n\n</td><td id=\"user_groups_value-SCIM-entry\">\n\nSys\\_id of an associated group record.Data type: String\n\n</td></tr><tr><td>\n\ngroups.$ref\n\n</td><td id=\"user_groups_ref-SCIM-entry\">\n\nURI of the associated group.Data type: String\n\n</td></tr><tr><td>\n\nid\n\n</td><td id=\"user_id-SCIM-entry\">\n\nSys\\_id of the associated User record.Data type: String\n\n</td></tr><tr><td>\n\nmeta\n\n</td><td id=\"user_meta-SCIM-entry\">\n\nMetadata pertaining to the user.Data type: Object\n\n```\n\"meta\": {\n  \"created\": \"String\",\n  \"lastModified\": \"String\",\n  \"location\": String\",\n  \"resourceType\": String\"\n}\n```\n\n</td></tr><tr><td>\n\nmeta.created\n\n</td><td id=\"user_meta_created-SCIM-entry\">\n\nDate and time when the user record was created.Data type: String\n\n</td></tr><tr><td>\n\nmeta.lastModified\n\n</td><td id=\"user_meta_lastModified-SCIM-entry\">\n\nDate and time when the user record was last modified.Data type: String\n\n</td></tr><tr><td>\n\nmeta.location\n\n</td><td id=\"user_meta_location-SCIM-entry\">\n\nURI of the user being retrieved.Data type: String\n\n</td></tr><tr><td>\n\nmeta.resourceType\n\n</td><td id=\"user_meta_resourceType-SCIM-entry\">\n\nSCIM Users' resource type.Data type: String\n\n</td></tr><tr><td>\n\nname\n\n</td><td id=\"d3262e1353\">\n\nUser's name information.Data type: Object\n\n```\n\"name\": {\n  \"familyName\": \"String\",\n  \"givenName\": \"String\",\n  \"honorificPrefix\": \"String\",\n  \"middleName\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nname.familyName\n\n</td><td id=\"d3262e1366\">\n\nUser's family or last name.Data type: String\n\n</td></tr><tr><td>\n\nname.givenName\n\n</td><td id=\"d3262e1377\">\n\nUser's given or first name.Data type: String\n\n</td></tr><tr><td>\n\nname.honorificPrefix\n\n</td><td id=\"d3262e1388\">\n\nUser's honorific name or title, such as Dr., Bishop, or Baron.Data type: String\n\n</td></tr><tr><td>\n\nname.middle\n\n</td><td id=\"d3262e1399\">\n\nUser's middle name.Data type: String\n\n</td></tr><tr><td>\n\nphoneNumbers\n\n</td><td id=\"d3262e1411\">\n\nList of phone numbers associated with the user.Data type: Array of Objects\n\n```\n\"phoneNumbers\": [\n  {\n    \"type\": \"String\",\n    \"value\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nphoneNumbers.type\n\n</td><td id=\"d3262e1424\">\n\nType of phone number.Possible values:\n\n-   home\n-   mobile\n-   work\n\nData type: String\n\n</td></tr><tr><td>\n\nphoneNumbers.value\n\n</td><td id=\"d3262e1448\">\n\nUser's phone number.Data type: String\n\n</td></tr><tr><td>\n\npreferredLanguage\n\n</td><td id=\"d3262e1459\">\n\nUser's preferred spoken and written language.Data type: String\n\n</td></tr><tr><td>\n\nschemas\n\n</td><td id=\"user_schemas-SCIM-entry\">\n\nList of URIs of the SCIM User schemas used to process the request.Data type: Array of Strings\n\n</td></tr><tr><td>\n\ntimezone\n\n</td><td id=\"d3262e1481\">\n\nUser's time zone.Data type: String\n\n</td></tr><tr><td>\n\ntitle\n\n</td><td id=\"d3262e1493\">\n\nUser's title, such as CEO or President.Data type: String\n\n</td></tr><tr><td>\n\nuserName\n\n</td><td id=\"user_userName-SCIM-entry\">\n\nUnique user name for the associated user. Data type: String\n\n</td></tr><tr><td>\n\nuserType\n\n</td><td id=\"d3262e1517\">\n\nUser type. This value is used to identify the organization to user relationship.This can be any value, but typical values might include:\n\n-   Contractor\n-   Employee\n-   Intern\n-   Temp\n-   External\n-   Unknown\n\nData type: String\n\n</td></tr></tbody>\n</table>### cURL request to POST user\n\nThis example shows how to POST the user Jack Sparrow to the User \\[sys\\_user\\] table.\n\n```\ncurl -X POST \\\n  https://instance-servicenow.com/api/now/scim/Users \\\n  -d '{\n    \"schemas\": [\n        \"urn:ietf:params:scim:schemas:extension:servicenow:2.0:User\",\n        \"urn:ietf:params:scim:schemas:core:2.0:User\"\n    ],\n    \"externalId\": \"123456\",\n    \"userName\": \"jack.sparrow\",\n    \"name\": {\n        \"familyName\": \"Sparrow\",\n        \"givenName\": \"Jack\"\n    },\n    \"title\": \"Senior Developer\",\n    \"preferredLanguage\": \"en\",\n    \"timezone\": \"ET\",\n    \"active\": true,\n    \"emails\": [\n      {\n        \"value\": \"jack.sparrow@abc.com\",\n        \"display\": null,\n        \"type\": \"work\",\n        \"primary\": true\n      }\n    ],\n    \"phoneNumbers\": [\n      {\n        \"value\": \"9977553312\",\n        \"type\": \"mobile\",\n        \"primary\": true\n      }\n    ]\n}'\n```\n\nResponse:\n\n```\n{\"schemas\":\n  [\n    \"urn:ietf:params:scim:schemas:extension:servicenow:2.0:User\",\n    \"urn:ietf:params:scim:schemas:core:2.0:User\"\n  ],\n  \"id\":\"d6287d7b1bbe3010593876a61a4bcbc3\",\n  \"externalId\":\"123456\",\n  \"meta\":{\n    \"resourceType\":\"User\",\n    \"created\":\"2021-10-01T16:46:48Z\",\n    \"lastModified\":\"2021-10-01T16:46:48Z\",\n    \"location\":\"https://instance-servicenow.com/api/now/scim/Users/d6287d7b1bbe3010593876a61a4bcbc3\"\n  },\n  \"userName\":\"jack.sparrow\",\n  \"name\":{\n    \"familyName\":\"Sparrow\",\n    \"givenName\":\"Jack\"\n  },\n  \"displayName\":\"Jack Sparrow\",\n  \"title\":\"Senior Developer\",\n  \"preferredLanguage\":\"en\",\n  \"timezone\":\"ET\",\n  \"active\":true,\n  \"emails\":[\n    {\n      \"value\":\"jack.sparrow@abc.com\",\n      \"type\":\"work\"\n    }\n  ],\n  \"phoneNumbers\":[\n    {\n      \"value\":\"9977553312\",\n      \"type\":\"mobile\"\n    }\n  ]\n}\n```\n\n## SCIM - PUT /scim/Users/\\{user\\_id\\}\n\nUpdates the specified user record in the User \\[sys\\_user\\] table of a ServiceNow instance using the System for Cross-domain Identity Management \\(SCIM\\) protocol.\n\n### URL format\n\nVersioned URL: `/api/now/{api_version}/scim/Users/{user_id}`\n\nDefault URL: `/api/now/scim/Users/{user_id}`\n\n**Note:** Available versions are specified in the [REST API Explorer](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/use-REST-API-Explorer.md). For scripted REST APIs there is additional version information on the [Scripted REST Service form](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_CustomWebServices.md).\n\n### Supported request parameters\n\n<table class=\"rest_api_path_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\napi\\_version\n\n</td><td id=\"version-entry-RESTAPI\">\n\nOptional. Version of the endpoint to access. For example, `v1` or `v2`. Only specify this value to use an endpoint version other than the latest. Data type: String\n\n</td></tr><tr><td>\n\nuser\\_id\n\n</td><td>\n\nSys\\_id of the user record to update.Data type: String\n\nTable: User \\[sys\\_user\\]\n\n</td></tr></tbody>\n</table><table class=\"rest_api_query_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nattributes\n\n</td><td id=\"attributes-SCIM-entry\">\n\nComma-separated list of fields to return in the response. No other fields are returned.Can't be used with the **excludedAttributes** parameter.\n\nData type: String\n\nDefault: Return all fields unless **excludedAttributes** is specified.\n\n</td></tr><tr><td>\n\nexcludedAttributes\n\n</td><td id=\"excludedAttributes-SCIM-entry\">\n\nComma-separated list of fields to exclude from the records returned in the response. All other fields are returned.Can't be used with the **attributes** parameter.\n\nData type: String\n\nDefault: Do not exclude any fields.\n\n</td></tr></tbody>\n</table><table class=\"rest_api_request_body\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nactive\n\n</td><td id=\"user_active-SCIM-entry\">\n\nFlag that indicates whether the associated user is active within the ServiceNow instance.Possible values:\n\n-   true: User is active.\n-   false: User is inactive.\n\nData type: Boolean\n\n</td></tr><tr><td>\n\naddresses\n\n</td><td id=\"user_addresses-SCIM-entry\">\n\nDetails of the user's current mailing address.Data type: Object\n\n```\n\"addresses\": {\n  \"country\": \"String\",\n  \"locality\": \"String\",\n  \"postalCode\": \"String\",\n  \"region\": \"String\",\n  \"streetAddress\": \"String\",\n  \"type\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\naddresses.country\n\n</td><td id=\"user_addresses_country-SCIM-entry\">\n\nCountry name.Data type: String\n\n</td></tr><tr><td>\n\naddresses.locality\n\n</td><td id=\"user_addresses_locality-SCIM-entry\">\n\nCity or locality name.Data type: String\n\n</td></tr><tr><td>\n\naddresses.postalCode\n\n</td><td id=\"user_addresses_postalCode-SCIM-entry\">\n\nZip or postal code.Data type: String\n\n</td></tr><tr><td>\n\naddresses.region\n\n</td><td id=\"user_addresses_region-SCIM-entry\">\n\nState or region.Data type: String\n\n</td></tr><tr><td>\n\naddresses.streetAddress\n\n</td><td id=\"user_addresses_streetAddress-SCIM-entry\">\n\nFull street address. This can include the house number, street name, PO Box, and multi-line extended street address information.Data type: String\n\n</td></tr><tr><td>\n\naddresses.type\n\n</td><td id=\"user_addresses_type-SCIM-entry\">\n\nType of address. Currently only supports `home`.Data type: String\n\n</td></tr><tr><td>\n\ndisplayName\n\n</td><td id=\"user_displayName-SCIM-entry\">\n\nUser display name. This value is auto-generated by concatenating the **name** fields. Data type: String\n\n</td></tr><tr><td>\n\nemails\n\n</td><td id=\"user_emails-SCIM-entry\">\n\nList of email accounts associated with the user.Data type: Array of Objects\n\n```\n\"emails:\" [\n  {\n    \"type\": \"String\",\n    \"value\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nemails.type\n\n</td><td id=\"user_emails_type-SCIM-entry\">\n\nUser email type. Currently only supports type of \"work\".Data type: String\n\n</td></tr><tr><td>\n\nemails.value\n\n</td><td id=\"user_emails_value-SCIM-entry\">\n\nUser's email address. This is a unique key for the associated user.Data type: String\n\n</td></tr><tr><td>\n\nexternalId\n\n</td><td id=\"user_emails_externalId-SCIM-entry\">\n\nUnique identifier assigned to the user by the entity provisioning it.Data type: String\n\n</td></tr><tr><td>\n\nname\n\n</td><td id=\"user_name-SCIM-entry\">\n\nUser's name information.Data type: Object\n\n```\n\"name\": {\n  \"familyName\": \"String\",\n  \"givenName\": \"String\",\n  \"honorificPrefix\": \"String\",\n  \"middleName\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nname.familyName\n\n</td><td id=\"user_name_familyName-SCIM-entry\">\n\nUser's family or last name.Data type: String\n\n</td></tr><tr><td>\n\nname.givenName\n\n</td><td id=\"user_name_givenName-SCIM-entry\">\n\nUser's given or first name.Data type: String\n\n</td></tr><tr><td>\n\nname.honorificPrefix\n\n</td><td id=\"user_name_honorificPrefix-SCIM-entry\">\n\nUser's honorific name or title, such as Dr., Bishop, or Baron.Data type: String\n\n</td></tr><tr><td>\n\nname.middle\n\n</td><td id=\"user_name_middle-SCIM-entry\">\n\nUser's middle name.Data type: String\n\n</td></tr><tr><td>\n\nphoneNumbers\n\n</td><td id=\"user_phoneNumbers-SCIM-entry\">\n\nList of phone numbers associated with the user.Data type: Array of Objects\n\n```\n\"phoneNumbers\": [\n  {\n    \"type\": \"String\",\n    \"value\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nphoneNumbers.type\n\n</td><td id=\"user_phoneNumbers_type-SCIM-entry\">\n\nType of phone number.Possible values:\n\n-   home\n-   mobile\n-   work\n\nData type: String\n\n</td></tr><tr><td>\n\nphoneNumbers.value\n\n</td><td id=\"user_phoneNumbers_value-SCIM-entry\">\n\nUser's phone number.Data type: String\n\n</td></tr><tr><td>\n\npreferredLanguage\n\n</td><td id=\"user_preferredLanguage-SCIM-entry\">\n\nUser's preferred spoken and written language.Data type: String\n\n</td></tr><tr><td>\n\ntimezone\n\n</td><td id=\"user_timezone-SCIM-entry\">\n\nUser's time zone.Data type: String\n\n</td></tr><tr><td>\n\ntitle\n\n</td><td id=\"user_title-SCIM-entry\">\n\nUser's title, such as CEO or President.Data type: String\n\n</td></tr><tr><td>\n\nuserName\n\n</td><td>\n\nRequired. Unique user name for the associated user. Data type: String\n\n</td></tr><tr><td>\n\nuserType\n\n</td><td id=\"user_userType-SCIM-entry\">\n\nUser type. This value is used to identify the organization to user relationship.This can be any value, but typical values might include:\n\n-   Contractor\n-   Employee\n-   Intern\n-   Temp\n-   External\n-   Unknown\n\nData type: String\n\n</td></tr><tr><td>\n\nExtended Schema\n\n</td><td>\n\n \n\n</td></tr><tr><td>\n\ncompany\n\n</td><td>\n\nDetails about the user's associated company.Data type: Object\n\n```\n\"company\": {\n  \"value\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\ncompany.value\n\n</td><td>\n\nRequired if company is included in post. Sys\\_id of the company record. Data type: String\n\n</td></tr><tr><td>\n\ncostCenter\n\n</td><td>\n\nDetails about the user's associated cost center.Data type: Object\n\n```\n\"costCenter\": {\n  \"value\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\ncostCenter.value\n\n</td><td>\n\nRequired if costCenter is included in post. Sys\\_id of the cost center record. Data type: String\n\n</td></tr><tr><td>\n\ndepartment\n\n</td><td>\n\nDetails about the user's associated department.Data type: Object\n\n```\n\"department\": {\n  \"value\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\ndepartment.value\n\n</td><td>\n\nRequired if department is included in post. Sys\\_id of the department record. Data type: String\n\n</td></tr><tr><td>\n\nemployeeNumber\n\n</td><td id=\"user_employeeNumber-SCIM-entry\">\n\nNumeric or alphanumeric employee number.Data type: String\n\n</td></tr><tr><td>\n\ngender\n\n</td><td id=\"user_gender-SCIM-entry\">\n\nGender of the user, such as male or female.Data type: String\n\n</td></tr><tr><td>\n\nlocation\n\n</td><td>\n\nDetails about the user's associated location.Data type: Object\n\n```\n\"location\": {\n  \"value\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nlocation.value\n\n</td><td>\n\nRequired if location is included in post. Sys\\_id of the location record. Data type: String\n\n</td></tr><tr><td>\n\nmanager\n\n</td><td>\n\nDetails about the user's associated manager.Data type: Object\n\n```\n\"manager\": {\n  \"value\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nmanager.value\n\n</td><td>\n\nRequired if manager is included in post. Sys\\_id of the manager record. Data type: String\n\n</td></tr></tbody>\n</table>### Headers\n\nThe following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table class=\"rest_api_request_headers\"><thead><tr><th>\n\nHeader\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nAccept\n\n</td><td id=\"Accept-SCIM-entry\">\n\nData format of the response body. Supported types: **application/json** or **application/scim+json**.Default: **application/json**\n\n</td></tr><tr><td>\n\nContent-Type\n\n</td><td id=\"Content_Type-SCIM-entry\">\n\nData format of the request body. Supported types: **application/json** or **application/scim+json**.Default: **application/json**\n\n</td></tr></tbody>\n</table>|Header|Description|\n|------|-----------|\n|None| |\n\n### Status codes\n\nThe following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n|Status code|Description|\n|-----------|-----------|\n|200|Successful. The request was successfully processed.|\n|404|Not found. The requested item wasn't found.|\n|409|User already exists. The **userName** parameter must be unique.|\n|500|Internal server error. An unexpected error occurred while processing the request. The response contains additional information about the error.|\n\n### Response body parameters \\(JSON\\)\n\n<table id=\"table_mjy_k1l_grb\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nactive\n\n</td><td id=\"d3262e1058\">\n\nFlag that indicates whether the associated user is active within the ServiceNow instance.Possible values:\n\n-   true: User is active.\n-   false: User is inactive.\n\nData type: Boolean\n\n</td></tr><tr><td>\n\naddresses\n\n</td><td id=\"d3262e1082\">\n\nDetails of the user's current mailing address.Data type: Object\n\n```\n\"addresses\": {\n  \"country\": \"String\",\n  \"locality\": \"String\",\n  \"postalCode\": \"String\",\n  \"region\": \"String\",\n  \"streetAddress\": \"String\",\n  \"type\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\naddresses.country\n\n</td><td id=\"d3262e1095\">\n\nCountry name.Data type: String\n\n</td></tr><tr><td>\n\naddresses.locality\n\n</td><td id=\"d3262e1106\">\n\nCity or locality name.Data type: String\n\n</td></tr><tr><td>\n\naddresses.postalCode\n\n</td><td id=\"d3262e1117\">\n\nZip or postal code.Data type: String\n\n</td></tr><tr><td>\n\naddresses.region\n\n</td><td id=\"d3262e1129\">\n\nState or region.Data type: String\n\n</td></tr><tr><td>\n\naddresses.streetAddress\n\n</td><td id=\"d3262e1140\">\n\nFull street address. This can include the house number, street name, PO Box, and multi-line extended street address information.Data type: String\n\n</td></tr><tr><td>\n\naddresses.type\n\n</td><td id=\"d3262e1151\">\n\nType of address. Currently only supports `home`.Data type: String\n\n</td></tr><tr><td>\n\ndisplayName\n\n</td><td id=\"d3262e1165\">\n\nUser display name. This value is auto-generated by concatenating the **name** fields. Data type: String\n\n</td></tr><tr><td>\n\nemails\n\n</td><td id=\"d3262e1179\">\n\nList of email accounts associated with the user.Data type: Array of Objects\n\n```\n\"emails:\" [\n  {\n    \"type\": \"String\",\n    \"value\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nemails.type\n\n</td><td id=\"d3262e1192\">\n\nUser email type. Currently only supports type of \"work\".Data type: String\n\n</td></tr><tr><td>\n\nemails.value\n\n</td><td id=\"d3262e1204\">\n\nUser's email address. This is a unique key for the associated user.Data type: String\n\n</td></tr><tr><td>\n\nerrors\n\n</td><td id=\"errors-SCIM-entry\">\n\nResponse that describes any errors that may have occurred during processing the request.Data type: Object\n\n```\n\"errors\": {\n  \"details\": \"String\",\n  \"schemas\": \"String\",\n  \"scimType\": \"String\",\n  \"status\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nerrors.detail\n\n</td><td id=\"errors_details-SCIM-entry\">\n\nDetailed error message on why the request failed.Data type: String\n\n</td></tr><tr><td>\n\nerrors.scimType\n\n</td><td id=\"errors_scimType-SCIM-entry\">\n\nSCIM error detail keyword.Data type: String\n\n</td></tr><tr><td>\n\nerrors.schemas\n\n</td><td id=\"errors_schemas-SCIM-entry\">\n\nURI of the SCIM Schemas used to process the error response.Data type: Array of Strings\n\n</td></tr><tr><td>\n\nerrors.status\n\n</td><td id=\"errors_status-SCIM-entry\">\n\nHTTP status code for the error response.Data type: String\n\n</td></tr><tr><td>\n\nexternalId\n\n</td><td id=\"d3262e1215\">\n\nUnique identifier assigned to the user by the entity provisioning it.Data type: String\n\n</td></tr><tr><td>\n\ngroups\n\n</td><td id=\"user_groups-SCIM-entry\">\n\nList of groups to which the user belongs, either through direct membership, nested groups, or dynamically calculated.Data type: Array of Objects\n\n```\n\"groups\": [\n  {\n    \"display\": \"String\",\n    \"type\": \"String\",\n    \"value\": \"String\",\n    \"$ref\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\ngroups.display\n\n</td><td id=\"user_groups_display-SCIM-entry\">\n\nName of the associated group.Data type: String\n\n</td></tr><tr><td>\n\ngroups.type\n\n</td><td id=\"user_groups_type-SCIM-entry\">\n\nType of group association, such as direct or indirect.Data type: String\n\n</td></tr><tr><td>\n\ngroups.value\n\n</td><td id=\"user_groups_value-SCIM-entry\">\n\nSys\\_id of an associated group record.Data type: String\n\n</td></tr><tr><td>\n\ngroups.$ref\n\n</td><td id=\"user_groups_ref-SCIM-entry\">\n\nURI of the associated group.Data type: String\n\n</td></tr><tr><td>\n\nid\n\n</td><td id=\"user_id-SCIM-entry\">\n\nSys\\_id of the associated User record.Data type: String\n\n</td></tr><tr><td>\n\nmeta\n\n</td><td id=\"user_meta-SCIM-entry\">\n\nMetadata pertaining to the user.Data type: Object\n\n```\n\"meta\": {\n  \"created\": \"String\",\n  \"lastModified\": \"String\",\n  \"location\": String\",\n  \"resourceType\": String\"\n}\n```\n\n</td></tr><tr><td>\n\nmeta.created\n\n</td><td id=\"user_meta_created-SCIM-entry\">\n\nDate and time when the user record was created.Data type: String\n\n</td></tr><tr><td>\n\nmeta.lastModified\n\n</td><td id=\"user_meta_lastModified-SCIM-entry\">\n\nDate and time when the user record was last modified.Data type: String\n\n</td></tr><tr><td>\n\nmeta.location\n\n</td><td id=\"user_meta_location-SCIM-entry\">\n\nURI of the user being retrieved.Data type: String\n\n</td></tr><tr><td>\n\nmeta.resourceType\n\n</td><td id=\"user_meta_resourceType-SCIM-entry\">\n\nSCIM Users' resource type.Data type: String\n\n</td></tr><tr><td>\n\nname\n\n</td><td id=\"d3262e1353\">\n\nUser's name information.Data type: Object\n\n```\n\"name\": {\n  \"familyName\": \"String\",\n  \"givenName\": \"String\",\n  \"honorificPrefix\": \"String\",\n  \"middleName\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nname.familyName\n\n</td><td id=\"d3262e1366\">\n\nUser's family or last name.Data type: String\n\n</td></tr><tr><td>\n\nname.givenName\n\n</td><td id=\"d3262e1377\">\n\nUser's given or first name.Data type: String\n\n</td></tr><tr><td>\n\nname.honorificPrefix\n\n</td><td id=\"d3262e1388\">\n\nUser's honorific name or title, such as Dr., Bishop, or Baron.Data type: String\n\n</td></tr><tr><td>\n\nname.middle\n\n</td><td id=\"d3262e1399\">\n\nUser's middle name.Data type: String\n\n</td></tr><tr><td>\n\nphoneNumbers\n\n</td><td id=\"d3262e1411\">\n\nList of phone numbers associated with the user.Data type: Array of Objects\n\n```\n\"phoneNumbers\": [\n  {\n    \"type\": \"String\",\n    \"value\": \"String\"\n  }\n]\n```\n\n</td></tr><tr><td>\n\nphoneNumbers.type\n\n</td><td id=\"d3262e1424\">\n\nType of phone number.Possible values:\n\n-   home\n-   mobile\n-   work\n\nData type: String\n\n</td></tr><tr><td>\n\nphoneNumbers.value\n\n</td><td id=\"d3262e1448\">\n\nUser's phone number.Data type: String\n\n</td></tr><tr><td>\n\npreferredLanguage\n\n</td><td id=\"d3262e1459\">\n\nUser's preferred spoken and written language.Data type: String\n\n</td></tr><tr><td>\n\nschemas\n\n</td><td id=\"user_schemas-SCIM-entry\">\n\nList of URIs of the SCIM User schemas used to process the request.Data type: Array of Strings\n\n</td></tr><tr><td>\n\ntimezone\n\n</td><td id=\"d3262e1481\">\n\nUser's time zone.Data type: String\n\n</td></tr><tr><td>\n\ntitle\n\n</td><td id=\"d3262e1493\">\n\nUser's title, such as CEO or President.Data type: String\n\n</td></tr><tr><td>\n\nuserName\n\n</td><td id=\"user_userName-SCIM-entry\">\n\nUnique user name for the associated user. Data type: String\n\n</td></tr><tr><td>\n\nuserType\n\n</td><td id=\"d3262e1517\">\n\nUser type. This value is used to identify the organization to user relationship.This can be any value, but typical values might include:\n\n-   Contractor\n-   Employee\n-   Intern\n-   Temp\n-   External\n-   Unknown\n\nData type: String\n\n</td></tr></tbody>\n</table>### Extension parameters returned\n\n<table id=\"id_hmw_fjk_grb\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr id=\"user_company-SCIM-row\"><td>\n\ncompany\n\n</td><td id=\"user_company-SCIM-entry\">\n\nDetails about the user's associated company.Data type: Object\n\n```\n\"company\": {\n  \"display\": \"String\",\n  \"value\": \"String\",\n  \"$ref\": \"String\"\n}\n```\n\n</td></tr><tr id=\"user_company_display-SCIM-row\"><td>\n\ncompany.display\n\n</td><td id=\"user_company_display-SCIM-entry\">\n\nName of the company.Data type: String\n\n</td></tr><tr id=\"user_company_value-SCIM-row\"><td>\n\ncompany.value\n\n</td><td id=\"user_company_value-SCIM-entry\">\n\nSys\\_id of the company record.Data type: String\n\n</td></tr><tr id=\"user_company_ref-SCIM-row\"><td>\n\ncompany.$ref\n\n</td><td id=\"user_company_ref-SCIM-entry\">\n\nReference URI for the company.Data type: String\n\n</td></tr><tr id=\"user_costCenter-SCIM-row\"><td>\n\ncostCenter\n\n</td><td id=\"user_costCenter-SCIM-entry\">\n\nDetails about the user's associated cost center.Data type: Object\n\n```\n\"costCenter\": {\n  \"display\": \"String\",\n  \"value\": \"String\",\n  \"$ref\": \"String\"\n}\n```\n\n</td></tr><tr id=\"user_costCenter_display-SCIM-row\"><td>\n\ncostCenter.display\n\n</td><td id=\"user_costCenter_display-SCIM-entry\">\n\nName of the cost center.Data type: String\n\n</td></tr><tr id=\"user_costCenter_value-SCIM-row\"><td>\n\ncostCenter.value\n\n</td><td id=\"user_costCenter_value-SCIM-entry\">\n\nSys\\_id of the cost center record. Data type: String\n\n</td></tr><tr id=\"user_costCenter_ref-SCIM-row\"><td>\n\ncostCenter.$ref\n\n</td><td id=\"user_costCenter_ref-SCIM-entry\">\n\nReference URI for the cost center.Data type: String\n\n</td></tr><tr id=\"user_department-SCIM-row\"><td>\n\ndepartment\n\n</td><td id=\"user_department-SCIM-entry\">\n\nDetails about the user's associated department.Data type: Object\n\n```\n\"department\": {\n  \"display\": \"String\",\n  \"value\": \"String\",\n  \"$ref\": \"String\"\n}\n```\n\n</td></tr><tr id=\"user_department_display-SCIM-row\"><td>\n\ndepartment.display\n\n</td><td id=\"user_department_display-SCIM-entry\">\n\nName of the department.Data type: String\n\n</td></tr><tr id=\"user_department_value-SCIM-row\"><td>\n\ndepartment.value\n\n</td><td id=\"user_department_value-SCIM-entry\">\n\nSys\\_id of the department record. Data type: String\n\n</td></tr><tr id=\"user_department_ref-SCIM-row\"><td>\n\ndepartment.$ref\n\n</td><td id=\"user_department_ref-SCIM-entry\">\n\nReference URI for the department.Data type: String\n\n</td></tr><tr id=\"user_employeeNumber-SCIM-row\"><td>\n\nemployeeNumber\n\n</td><td id=\"d3262e1722\">\n\nNumeric or alphanumeric employee number.Data type: String\n\n</td></tr><tr id=\"user_gender-SCIM-row\"><td>\n\ngender\n\n</td><td id=\"d3262e1733\">\n\nGender of the user, such as male or female.Data type: String\n\n</td></tr><tr id=\"user_location-SCIM-row\"><td>\n\nlocation\n\n</td><td id=\"user_location-SCIM-entry\">\n\nDetails about the user's associated location.Data type: Object\n\n```\n\"location\": {\n  \"display\": \"String\",\n  \"value\": \"String\",\n  \"$ref\": \"String\"\n}\n```\n\n</td></tr><tr id=\"user_location_display-SCIM-row\"><td>\n\nlocation.display\n\n</td><td id=\"user_location_display-SCIM-entry\">\n\nName of the location.Data type: String\n\n</td></tr><tr id=\"user_location_value-SCIM-row\"><td>\n\nlocation.value\n\n</td><td id=\"user_location_value-SCIM-entry\">\n\nSys\\_id of the location record. Data type: String\n\n</td></tr><tr id=\"user_location_ref-SCIM-row\"><td>\n\nlocation.$ref\n\n</td><td id=\"user_location_ref-SCIM-entry\">\n\nReference URI for the location.Data type: String\n\n</td></tr><tr id=\"user_manager-SCIM-row\"><td>\n\nmanager\n\n</td><td id=\"user_manager-SCIM-entry\">\n\nDetails about the user's associated manager.Data type: Object\n\n```\n\"manager\": {\n  \"display\": \"String\",\n  \"value\": \"String\",\n  \"$ref\": \"String\"\n}\n```\n\n</td></tr><tr id=\"user_manager_display-SCIM-row\"><td>\n\nmanager.display\n\n</td><td id=\"user_manager_display-SCIM-entry\">\n\nName of the manager.Data type: String\n\n</td></tr><tr id=\"user_manager_value-SCIM-row\"><td>\n\nmanager.value\n\n</td><td id=\"user_manager_value-SCIM-entry\">\n\nSys\\_id of the manager record. Data type: String\n\n</td></tr><tr id=\"user_manager_ref-SCIM-row\"><td>\n\nmanager.$ref\n\n</td><td id=\"user_manager_ref-SCIM-entry\">\n\nReference URI for the manager.Data type: String\n\n</td></tr></tbody>\n</table>### cURL request to update user information using PUT\n\nThis example shows how to update the information of an existing user using the PUT endpoint.\n\n```\ncurl -X PUT \\\n  https://instance-servicenow.com/api/now/scim/Users/cdfef423e0423010f8778ac6d674f5ae \\\n  -d '{\n  \"schemas\": [\n    \"urn:ietf:params:scim:schemas:extension:servicenow:2.0:User\",\n    \"urn:ietf:params:scim:schemas:core:2.0:User\"\n  ],\n  \"externalId\": \"123457\",\n  \"userName\": \"john.Doe\",\n  \"name\": {\n    \"familyName\": \"Doe\",\n    \"givenName\": \"John\"\n  },\n  \"title\": \"Sir\",\n  \"preferredLanguage\": \"en\",\n  \"timezone\": \"ET\",\n  \"active\": true,\n  \"emails\": [\n    {\n      \"value\": \"john.doe@abc.com\",\n      \"display\": null,\n      \"type\": \"work\",\n      \"primary\": true\n    }\n  ],\n  \"phoneNumbers\": [\n    {\n      \"value\": \"9977553312\",\n      \"type\": \"mobile\",\n      \"primary\": true\n    }\n  ],\n  \"urn:ietf:params:scim:schemas:extension:servicenow:2.0:User\": {\n    \"gender\": \"Male\",\n    \"employeeNumber\" : \"13453\",\n    \"location\" : {\n      \"value\" : \"0002c0a93790200044e0bfc8bcbe5df5\"\n    },\n    \"company\" : {\n      \"value\" : \"81fd65ecac1d55eb42a426568fc87a63\"\n    },\n    \"costCenter\" : {\n      \"value\" : \"7fb1cc99c0a80a6d30c04574d14c0acf\"\n    },\n    \"department\" : {\n      \"value\":\"221db0edc611228401760aec06c9d929\"\n    }\n  }\n}'\n```\n\nResponse:\n\n```\n{\n  \"schemas\": [\n    \"urn:ietf:params:scim:schemas:extension:servicenow:2.0:User\",\n    \"urn:ietf:params:scim:schemas:core:2.0:User\"\n  ],\n  \"id\": \"b7c5015f778330102e8cc5179e5a9992\",\n  \"externalId\": \"123457\",\n  \"meta\": {\n    \"resourceType\": \"User\",\n    \"created\": \"2021-10-12T10:05:32Z\",\n    \"lastModified\": \"2021-10-12T10:08:04Z\",\n    \"location\":\n      \"http://instance-servicenow.com/api/now/scim/Users/b7c5015f778330102e8cc5179e5a9992\"\n  },\n  \"userName\": \"john.doe\",\n  \"name\": {\n    \"familyName\": \"Doe\",\n    \"givenName\": \"John\"\n  },\n  \"displayName\": \"John Doe\",\n  \"title\": \"Sir\",\n  \"preferredLanguage\": \"en\",\n  \"timezone\": \"ET\",\n  \"active\": true,\n  \"emails\": [\n    {\n      \"value\": \"tony.stark@abc.com\",\n      \"type\": \"work\"\n    }\n  ],\n  \"phoneNumbers\": [\n    {\n      \"value\": \"9977553312\",\n      \"type\": \"mobile\"\n    }\n  ],\n  \"urn:ietf:params:scim:schemas:extension:servicenow:2.0:User\": {\n    \"employeeNumber\": \"13453\",\n    \"gender\": \"Male\",\n    \"costCenter\": {\n      \"value\": \"7fb1cc99c0a80a6d30c04574d14c0acf\",\n      \"name\": \"Sales\",\n      \"$ref\":\n       \"http://instance-servicenow.com/api/now/scim/CostCenters/7fb1cc99c0a80a6d30c04574d14c0acf\"\n    },\n    \"company\": {\n      \"value\": \"81fd65ecac1d55eb42a426568fc87a63\",\n      \"name\": \"ACME Japan\",\n      \"$ref\":\n       \"http://instance-servicenow.com/api/now/scim/Companies/81fd65ecac1d55eb42a426568fc87a63\"\n    },\n    \"department\": {\n      \"value\": \"221db0edc611228401760aec06c9d929\",\n      \"name\": \"Sales\",\n      \"$ref\":\n        \"http://instance-servicenow.com/api/now/scim/Departments/221db0edc611228401760aec06c9d929\"\n    },\n    \"manager\": {\n      \"value\": \"7027fda8773230102e8cc5179e5a99ea\",\n      \"displayName\": \"Jack Sparrow\",\n      \"$ref\":\n        \"http://instance-servicenow.com/api/now/scim/Users/7027fda8773230102e8cc5179e5a99ea\"\n    },\n    \"location\": {\n      \"value\": \"0002c0a93790200044e0bfc8bcbe5df5\",\n      \"name\": \"2-10-1 Yurakucho, Chiyoda-ku, Tokyo\",\n      \"$ref\":\n        \"http://instance-servicenow.com/api/now/scim/Locations/0002c0a93790200044e0bfc8bcbe5df5\"\n    }\n  }\n}\n```\n\n## SCIM - GET /scim/ResourceTypes\n\nRetrieves information about all System for Cross-domain Identity Management \\(SCIM\\) resource types supported by the associated ServiceNow instance.\n\nThis is a public endpoint and does not require any roles to access.\n\n### URL format\n\nVersioned URL: `/api/now/{api_version}/scim/ResourceTypes`\n\nDefault URL: `/api/now/scim/ResourceTypes`\n\n**Note:** Available versions are specified in the [REST API Explorer](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/use-REST-API-Explorer.md). For scripted REST APIs there is additional version information on the [Scripted REST Service form](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_CustomWebServices.md).\n\n### Supported request parameters\n\n<table class=\"rest_api_path_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\napi\\_version\n\n</td><td id=\"version-entry-RESTAPI\">\n\nOptional. Version of the endpoint to access. For example, `v1` or `v2`. Only specify this value to use an endpoint version other than the latest. Data type: String\n\n</td></tr></tbody>\n</table>|Name|Description|\n|----|-----------|\n|None| |\n\n|Name|Description|\n|----|-----------|\n|None| |\n\n### Headers\n\nThe following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table class=\"rest_api_request_headers\"><thead><tr><th>\n\nHeader\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nAccept\n\n</td><td id=\"Accept-SCIM-entry\">\n\nData format of the response body. Supported types: **application/json** or **application/scim+json**.Default: **application/json**\n\n</td></tr></tbody>\n</table>|Header|Description|\n|------|-----------|\n|None| |\n\n### Status codes\n\nThe following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n|Status code|Description|\n|-----------|-----------|\n|200|Successful. The request was successfully processed.|\n\n### Response body parameters \\(JSON\\)\n\n<table id=\"id_avz_rp3_3rb\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nitemsPerPage\n\n</td><td id=\"itemsPerPage-SCIM-entry\">\n\nNumber of records returned in the return results.Data type: Number\n\n</td></tr><tr><td>\n\nResources\n\n</td><td>\n\nList of available resource types.Data type: Array of Objects\n\n```\n\"Resources\": [\n  {\n    \"description\": \"String\",\n    \"endpoint\": \"String\",\n    \"id\": \"String\",\n    \"meta\": {Object},\n    \"name\": \"String\",\n    \"schema\": \"String\"\n    \"schemas\": [Array],\n    \"schemaExtensions\": [Array]\n  }\n]\n```\n\n</td></tr><tr><td>\n\nResources.description\n\n</td><td id=\"description-SCIM-entry\">\n\nBrief description of the resource type.Data type: String\n\n</td></tr><tr><td>\n\nResources.endpoint\n\n</td><td id=\"endpoint-SCIM-entry\">\n\nName of the HTTP-addressable endpoint relative to the Base URL of the service provider, for example \"Users\".Data type: String\n\n</td></tr><tr><td>\n\nResources.id\n\n</td><td id=\"id-SCIM-entry\">\n\nUnique identifier for the resource. Use this attribute when calling GET /scim/ResourceType/\\{resource\\_id\\} endpoint.Data type: String\n\n</td></tr><tr><td>\n\nResources.meta\n\n</td><td id=\"meta-SCIM-entry\">\n\nInformation that further describes the associated resource.Data type: Object\n\n```\n\"metadata\": {\n  \"location\": \"String\",\n  \"resourceType\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nResources.meta.location\n\n</td><td id=\"meta_location-SCIM-entry\">\n\nURI of the associated resource type on the associated ServiceNow instance.Data type: String\n\n</td></tr><tr><td>\n\nResources.meta.resourceType\n\n</td><td id=\"meta_resourceType-SCIM-entry\">\n\nAlways \"ResourceType\".Data type: String\n\n</td></tr><tr><td>\n\nResources.name\n\n</td><td id=\"name-SCIM-entry\">\n\nName of the resource type, such as User or Group.Data type: String\n\n</td></tr><tr><td>\n\nResources.schema\n\n</td><td id=\"schema-SCIM-entry\">\n\nResource type's primary/base schema URI. For example: `\"urn:ietf:params:scim:schemas:core:2.0:User\"`.Data type: String\n\n</td></tr><tr><td>\n\nResources.schemas\n\n</td><td id=\"schemas-SCIM-entry\">\n\nSchema used to process the `/ResourceType` request. For example: `\"urn:ietf:params:scim:schemas:core:2.0:ResourceType\"`.Data type: String\n\n</td></tr><tr><td>\n\nResources.schemaExtensions\n\n</td><td id=\"schemaExtensions-SCIM-entry\">\n\nList of schema extensions that apply to the associated resource type. For example: `\"urn:ietf:params:scim:schemas:extension: servicenow:2.0:User\"`.Data type: Array of Object\n\n```\n\"schemaExtensions\": {\n  \"required\": Boolean,\n  \"schema\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nResources.schemaExtensions.required\n\n</td><td id=\"schemaExtensions_required-SCIM-entry\">\n\nFlag that indicates whether the schema extension is required for the resource type.Possible values:\n\n-   true: A resource of this type must include this schema extension and also include any attributes declared as required in this schema extension.\n-   false: A resource of this type may omit this schema extension.\n\nData type: Boolean\n\n</td></tr><tr><td>\n\nResources.schemaExtensions.schema\n\n</td><td id=\"schemaExtensions_schema-SCIM-entry\">\n\nURI of an extended schema. For example: `\"urn:ietf:params:scim:schemas:extension:servicenow: 2.0:User\"`.Data type: String\n\n</td></tr><tr><td>\n\nschemas\n\n</td><td id=\"schemas2-SCIM-entry\">\n\nSchema used to process the list response to the request. For example: `\"urn:ietf:params:scim:api:messages:2.0:ListResponse\"` Data type: String\n\n</td></tr><tr><td>\n\nstartIndex\n\n</td><td id=\"startIndex-SCIM-entry\">\n\nOne-based index into the Resource table at which records were retrieved. Data type: String\n\n</td></tr><tr><td>\n\ntotalResults\n\n</td><td id=\"totalResults-SCIM-entry\">\n\nTotal number of records that match the request.Data type: Number\n\n</td></tr></tbody>\n</table>### cURL request\n\nThe following example shows how to obtain the SCIM resource types supported by a ServiceNow instance.\n\n```\ncurl \"https://instance-servicenow.com/api/now/scim/ResourceTypes \\\n--request GET \\\n--header \"Accept:application/scim+json\" \\\n```\n\nResponse:\n\n```\n{\n  \"schemas\":[\n    \"urn:ietf:params:scim:api:messages:2.0:ListResponse\"\n  ],\n  \"totalResults\":6,\n  \"Resources\":[\n    {\n      \"schemas\":[\n        \"urn:ietf:params:scim:schemas:core:2.0:ResourceType\"\n      ],\n      \"id\":\"User\",\n      \"name\":\"User\",\n      \"description\":\"User Account\",\n      \"endpoint\":\"/Users\",\n      \"schema\":\"urn:ietf:params:scim:schemas:core:2.0:User\",\n      \"schemaExtensions\":[\n        {\n          \"schema\":\"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User\",\n          \"required\":false\n        },\n        {\n          \"schema\":\"urn:ietf:params:scim:schemas:extension:servicenow:2.0:User\",\n          \"required\":false\n        }\n      ],\n      \"meta\":{\n        \"resourceType\":\"ResourceType\",\n        \"location\":\"https://instance-servicenow.com/api/now/scim/ResourceTypes/User\"\n      }\n    },\n    {\n      \"schemas\":[\n        \"urn:ietf:params:scim:schemas:core:2.0:ResourceType\"\n      ],\n      \"id\":\"Group\",\n      \"name\":\"Group\",\n      \"description\":\"Group\",\n      \"endpoint\":\"/Groups\",\n      \"schema\":\"urn:ietf:params:scim:schemas:core:2.0:Group\",\n      \"meta\":{\n        \"resourceType\":\"ResourceType\",\n        \"location\":\"https://instance-servicenow.service-now.com/api/now/scim/ResourceTypes/Group\"\n      }\n    },\n    {\n      \"schemas\":[\n        \"urn:ietf:params:scim:schemas:core:2.0:ResourceType\"\n      ],\n      \"id\":\"Company\",\n      \"name\":\"Company\",\n      \"description\":\"Company\",\n      \"endpoint\":\"/Companies\",\n      \"schema\":\"urn:ietf:params:scim:schemas:custom:servicenow:2.0:Company\",\n      \"meta\":{\n        \"resourceType\":\"ResourceType\",\n        \"location\":\"https://instance-servicenow.com/api/now/scim/ResourceTypes/Company\"\n      }\n    },\n    {\n      \"schemas\":[\n        \"urn:ietf:params:scim:schemas:core:2.0:ResourceType\"\n      ],\n      \"id\":\"Department\",\n      \"name\":\"Department\",\n      \"description\":\"Department\",\n      \"endpoint\":\"/Departments\",\n      \"schema\":\"urn:ietf:params:scim:schemas:custom:servicenow:2.0:Department\",\n      \"meta\":{\n        \"resourceType\":\"ResourceType\",\n        \"location\":\"https://instance-servicenow.com/api/now/scim/ResourceTypes/Department\"\n      }\n    },\n    {\n      \"schemas\":[\n        \"urn:ietf:params:scim:schemas:core:2.0:ResourceType\"\n      ],\n      \"id\":\"CostCenter\",\n      \"name\":\"CostCenter\",\n      \"description\":\"CostCenter\",\n      \"endpoint\":\"/CostCenters\",\n      \"schema\":\"urn:ietf:params:scim:schemas:custom:servicenow:2.0:CostCenter\",\n      \"meta\":{\n        \"resourceType\":\"ResourceType\",\n        \"location\":\"https://instance-servicenow.com/api/now/scim/ResourceTypes/CostCenter\"\n      }\n    },\n    {\n      \"schemas\":[\n        \"urn:ietf:params:scim:schemas:core:2.0:ResourceType\"\n      ],\n      \"id\":\"Location\",\n      \"name\":\"Location\",\n      \"description\":\"Location\",\n      \"endpoint\":\"/Locations\",\n      \"schema\":\"urn:ietf:params:scim:schemas:custom:servicenow:2.0:Location\",\n      \"meta\":{\n        \"resourceType\":\"ResourceType\",\n        \"location\":\"https://instance-servicenow.com/api/now/scim/ResourceTypes/Location\"\n      }\n    }\n  ],\n  \"startIndex\":1,\n  \"itemsPerPage\":6\n}\n```\n\n## SCIM - GET /scim/ResourceTypes/\\{ResourceName\\}\n\nRetrieves information about the specified System for Cross-domain Identity Management \\(SCIM\\) resource type.\n\nThis is a public endpoint and does not require any roles to access.\n\n### URL format\n\nVersioned URL: `/api/now/{api_version}/scim/ResourceTypes/{ResourceName}`\n\nDefault URL: `/api/now/scim/ResourceTypes/{ResourceName}`\n\n**Note:** Available versions are specified in the [REST API Explorer](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/use-REST-API-Explorer.md). For scripted REST APIs there is additional version information on the [Scripted REST Service form](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_CustomWebServices.md).\n\n### Supported request parameters\n\n<table class=\"rest_api_path_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\napi\\_version\n\n</td><td id=\"version-entry-RESTAPI\">\n\nOptional. Version of the endpoint to access. For example, `v1` or `v2`. Only specify this value to use an endpoint version other than the latest. Data type: String\n\n</td></tr><tr><td>\n\nResourceName\n\n</td><td>\n\nUnique ID of the resource type to retrieve.Valid values:\n\n-   Company\n-   CostCenter\n-   Department\n-   Group\n-   Location\n-   User\n\n Data type: String\n\n</td></tr></tbody>\n</table>|Name|Description|\n|----|-----------|\n|None| |\n\n|Name|Description|\n|----|-----------|\n|None| |\n\n### Headers\n\nThe following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table class=\"rest_api_request_headers\"><thead><tr><th>\n\nHeader\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nAccept\n\n</td><td id=\"Accept-SCIM-entry\">\n\nData format of the response body. Supported types: **application/json** or **application/scim+json**.Default: **application/json**\n\n</td></tr></tbody>\n</table>|Header|Description|\n|------|-----------|\n|None| |\n\n### Status codes\n\nThe following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n|Status code|Description|\n|-----------|-----------|\n|200|Successful. The request was successfully processed.|\n|404|Not found. The requested item wasn't found.|\n\n### Response body parameters \\(JSON\\)\n\n<table id=\"id_avz_rp3_3rb\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\ndescription\n\n</td><td>\n\nBrief description of the resource type.Data type: String\n\n</td></tr><tr><td>\n\nendpoint\n\n</td><td>\n\nName of the HTTP-addressable endpoint relative to the Base URL of the service provider, for example \"Companies\".Data type: String\n\n</td></tr><tr><td>\n\nid\n\n</td><td>\n\nUnique identifier for the resource. Use this attribute when calling GET /scim/ResourceType/\\{resource\\_id\\} endpoint.Data type: String\n\n</td></tr><tr><td>\n\nmeta\n\n</td><td>\n\nInformation that further describes the associated resource.Data type: Object\n\n```\n\"metadata\": {\n  \"location\": \"String\",\n  \"resourceType\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nmeta.location\n\n</td><td>\n\nURI of the associated resource type on the associated ServiceNow instance.Data type: String\n\n</td></tr><tr><td>\n\nmeta.resourceType\n\n</td><td>\n\nAlways \"ResourceType\".Data type: String\n\n</td></tr><tr><td>\n\nname\n\n</td><td>\n\nName of the resource type, such as User or Group.Data type: String\n\n</td></tr><tr><td>\n\nschema\n\n</td><td>\n\nResource type's primary/base schema URI. For example: `\"urn:ietf:params:scim:schemas:core:2.0:User\"`.Data type: String\n\n</td></tr><tr><td>\n\nschemas\n\n</td><td>\n\nSchema used to process the `/ResourceType` request. For example: `\"urn:ietf:params:scim:schemas:core:2.0:ResourceType\"`.Data type: String\n\n</td></tr><tr><td>\n\nschemaExtensions\n\n</td><td>\n\nList of schema extensions that apply to the associated resource type. For example: `\"urn:ietf:params:scim:schemas:extension: servicenow:2.0:User\"`.Data type: Array of Object\n\n```\n\"schemaExtensions\": {\n  \"required\": Boolean,\n  \"schema\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nschemaExtensions.required\n\n</td><td>\n\nFlag that indicates whether the schema extension is required for the resource type.Possible values:\n\n-   true: A resource of this type must include this schema extension and also include any attributes declared as required in this schema extension.\n-   false: A resource of this type may omit this schema extension.\n\nData type: Boolean\n\n</td></tr><tr><td>\n\nschemaExtensions.schema\n\n</td><td>\n\nURI of an extended schema. For example: `\"urn:ietf:params:scim:schemas:extension:servicenow: 2.0:User\"`.Data type: String\n\n</td></tr><tr><td>\n\nschemas\n\n</td><td>\n\nSchema used to process the list response to the request. For example: `\"urn:ietf:params:scim:api:messages:2.0:ListResponse\"` Data type: String\n\n</td></tr></tbody>\n</table>### cURL request\n\nThe following example shows how to obtain the User SCIM resource type from a ServiceNow instance.\n\n```\ncurl \"https://instance-servicenow.com/api/now/scim/ResourceTypes/\"User\" \\\n--request GET \\\n--header \"Accept:application/scim+json\" \\\n```\n\nResponse:\n\n```\n{\n  \"schemas\":[\n    \"urn:ietf:params:scim:schemas:core:2.0:ResourceType\"\n  ],\n  \"id\":\"User\",\n  \"name\":\"User\",\n  \"description\":\"User Account\",\n  \"endpoint\":\"/Users\",\n  \"schema\":\"urn:ietf:params:scim:schemas:core:2.0:User\",\n  \"schemaExtensions\":[\n    {\n      \"schema\":\"urn:ietf:params:scim:schemas:extension:servicenow:2.0:User\",\n      \"required\":false\n    },\n    {\n      \"schema\":\"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User\",\n      \"required\":false\n    }\n  ],\n  \"meta\":{\n    \"resourceType\":\"ResourceType\",\n    \"location\":\"https://instance-servicenow.com/api/now/scim/ResourceTypes/User\"\n  }\n}\n```\n\n## SCIM - GET /scim/Schemas\n\nRetrieves information about all System for Cross-domain Identity Management \\(SCIM\\) resource schemas supported by a ServiceNow instance. These schemas define the attributes available for each resource type.\n\nThis is a public endpoint and does not require any roles to access.\n\n### URL format\n\nVersioned URL: `/api/now/{api_version}/scim/Schemas`\n\nDefault URL: `/api/now/scim/Schemas`\n\n**Note:** Available versions are specified in the [REST API Explorer](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/use-REST-API-Explorer.md). For scripted REST APIs there is additional version information on the [Scripted REST Service form](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_CustomWebServices.md).\n\n### Supported request parameters\n\n<table class=\"rest_api_path_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\napi\\_version\n\n</td><td id=\"version-entry-RESTAPI\">\n\nOptional. Version of the endpoint to access. For example, `v1` or `v2`. Only specify this value to use an endpoint version other than the latest. Data type: String\n\n</td></tr></tbody>\n</table>|Name|Description|\n|----|-----------|\n|None| |\n\n|Name|Description|\n|----|-----------|\n|None| |\n\n### Headers\n\nThe following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table class=\"rest_api_request_headers\"><thead><tr><th>\n\nHeader\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nAccept\n\n</td><td id=\"Accept-SCIM-entry\">\n\nData format of the response body. Supported types: **application/json** or **application/scim+json**.Default: **application/json**\n\n</td></tr></tbody>\n</table>|Header|Description|\n|------|-----------|\n|None| |\n\n### Status codes\n\nThe following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n|Status code|Description|\n|-----------|-----------|\n|200|Successful. The request was successfully processed.|\n\n### Response body parameters \\(JSON\\)\n\n|Name|Description|\n|----|-----------|\n|Standard RFC7643 return results|Method returns results in compliance with the RFC7643 standard. For details see [Schema Definition](https://datatracker.ietf.org/doc/html/rfc7643#section-7) in the RFC7643 specification.|\n\n### cURL request\n\nThe following example shows how to obtain the SCIM schemas supported by a ServiceNow instance.\n\n```\ncurl \"https://instance-servicenow.com/api/now/scim/Schemas \\\n--request GET \\\n--header \"Accept:application/scim+json\" \\\n```\n\nResponse:\n\n```\n{\n  \"schemas\":[\n    \"urn:ietf:params:scim:api:messages:2.0:ListResponse\"\n  ],\n  \"totalResults\":8,\n  \"Resources\":[\n    {\n      \"schemas\":[\n        \"urn:ietf:params:scim:schemas:core:2.0:Schema\"\n      ],\n      \"id\":\"urn:ietf:params:scim:schemas:core:2.0:User\",\n      \"name\":\"User\",\n      \"description\":\"User Account\",\n      \"attributes\":[\n        {\n          \"name\":\"active\",\n          \"type\":\"boolean\",\n          \"multiValued\":false,\n          \"description\":\"A Boolean value indicating the User's administrative status.\",\n          \"required\":false,\n          \"caseExact\":true,\n          \"mutability\":\"readWrite\",\n          \"returned\":\"default\",\n          \"uniqueness\":\"none\"\n        },\n        {\n          \"name\":\"addresses\",\n          \"type\":\"complex\",\n          \"subAttributes\":[\n            {\n              \"name\":\"country\",\n              \"type\":\"string\",\n              \"multiValued\":false,\n              \"description\":\"The country name component.\",\n              \"required\":false,\n              \"caseExact\":false,\n              \"mutability\":\"readWrite\",\n              \"returned\":\"default\",\n              \"uniqueness\":\"none\"\n            },\n            {\n              \"name\":\"formatted\",\n              \"type\":\"string\",\n              \"multiValued\":false,\n              \"description\":\"The full mailing address, formatted for display or use with a mailing label. This attribute MAY contain newlines.\",\n              \"required\":false,\n              \"caseExact\":false,\n              \"mutability\":\"readWrite\",\n              \"returned\":\"default\",\n              \"uniqueness\":\"none\"\n            },\n            {\n              \"name\":\"locality\",\n              \"type\":\"string\",\n              \"multiValued\":false,\n              \"description\":\"The city or locality component.\",\n              \"required\":false,\n              \"caseExact\":false,\n              \"mutability\":\"readWrite\",\n              \"returned\":\"default\",\n              \"uniqueness\":\"none\"\n            },\n            {\n              \"name\":\"postalCode\",\n              \"type\":\"string\",\n              \"multiValued\":false,\n              \"description\":\"The zipcode or postal code component.\",\n              \"required\":false,\n              \"caseExact\":false,\n              \"mutability\":\"readWrite\",\n              \"returned\":\"default\",\n              \"uniqueness\":\"none\"\n            },\n            {\n              \"name\":\"primary\",\n              \"type\":\"boolean\",\n              \"multiValued\":false,\n              \"description\":\"A Boolean value indicating the 'primary' or \n                preferred attribute value for this attribute, e.g., the preferred address. \n                The primary attribute value 'true' MUST appear no more than once.\",\n              \"required\":false,\n              \"caseExact\":true,\n              \"mutability\":\"readWrite\",\n              \"returned\":\"default\",\n              \"uniqueness\":\"none\"\n            },\n            {\n              \"name\":\"region\",\n              \"type\":\"string\",\n              \"multiValued\":false,\n              \"description\":\"The state or region component.\",\n              \"required\":false,\n              \"caseExact\":false,\n              \"mutability\":\"readWrite\",\n              \"returned\":\"default\",\n              \"uniqueness\":\"none\"\n            },\n            {\n              \"name\":\"streetAddress\",\n              \"type\":\"string\",\n              \"multiValued\":false,\n              \"description\":\"The full street address component, which may include house number, \n                street name, PO BOX, and multi-line extended street address information. This \n                attribute MAY contain newlines.\",\n              \"required\":false,\n              \"caseExact\":false,\n              \"mutability\":\"readWrite\",\n              \"returned\":\"default\",\n              \"uniqueness\":\"none\"\n            },\n            {\n              \"name\":\"type\",\n              \"type\":\"string\",\n              \"multiValued\":false,\n              \"description\":\"A label indicating the attribute's function; e.g., 'work' or 'home'.\",\n              \"required\":false,\n              \"canonicalValues\":[\"other\",\"work\",\"home\"],\n              \"caseExact\":false,\n              \"mutability\":\"readWrite\",\n              \"returned\":\"default\",\n              \"uniqueness\":\"none\"\n            }\n          ],\n          \"multiValued\":true,\n          \"description\":\"Physical mailing addresses for this User.\",\n          \"required\":false,\n          \"caseExact\":true,\n          \"mutability\":\"readWrite\",\n          \"returned\":\"default\",\n          \"uniqueness\":\"none\"\n        },\n.\n.\n.\n      {\n        \"schemas\":[\n          \"urn:ietf:params:scim:schemas:core:2.0:Schema\"\n        ],\n        \"id\":\"urn:ietf:params:scim:schemas:custom:servicenow:2.0:Department\",\n        \"name\":\"Department\",\n        \"description\":\"Department\",\n        \"attributes\":[\n          {\n            \"name\":\"name\",\n            \"type\":\"string\",\n            \"multiValued\":false,\n            \"description\":\"The name of the department.\",\n            \"required\":false,\n            \"caseExact\":false,\n            \"mutability\":\"readOnly\",\n            \"returned\":\"default\",\n            \"uniqueness\":\"none\"\n          }\n        ],\n        \"meta\":{\n          \"resourceType\":\"Schema\",\n          \"location\":\"https://instance-servicenow.com/api/now/scim/Schemas/urn:ietf:params:scim:schemas:custom:servicenow:2.0:Department\"\n        }\n      },\n      {\n        \"schemas\":[\n          \"urn:ietf:params:scim:schemas:core:2.0:Schema\"\n        ],\n        \"id\":\"urn:ietf:params:scim:schemas:custom:servicenow:2.0:CostCenter\",\n        \"name\":\"CostCenter\",\n        \"description\":\"CostCenter\",\n        \"attributes\":[\n          {\n            \"name\":\"name\",\n            \"type\":\"string\",\n            \"multiValued\":false,\n            \"description\":\"The name of the cost center.\",\n            \"required\":false,\n            \"caseExact\":false,\n            \"mutability\":\"readOnly\",\n            \"returned\":\"default\",\n            \"uniqueness\":\"none\"\n          }\n        ],\n        \"meta\":\n          {\n            \"resourceType\":\"Schema\",\n            \"location\":\"https://instance.servicenow.com/api/now/scim/Schemas/urn:ietf:params:scim:schemas:custom:servicenow:2.0:CostCenter\"\n         }\n        },\n        {\n          \"schemas\":[\n            \"urn:ietf:params:scim:schemas:core:2.0:Schema\"\n          ],\n        \"id\":\"urn:ietf:params:scim:schemas:custom:servicenow:2.0:Location\",\n        \"name\":\"Location\",\n        \"description\":\"Location\",\n        \"attributes\":[\n          {\n            \"name\":\"name\",\n            \"type\":\"string\",\n            \"multiValued\":false,\n            \"description\":\"The location name.\",\n            \"required\":false,\n            \"caseExact\":false,\n            \"mutability\":\"readOnly\",\n            \"returned\":\"default\",\n            \"uniqueness\":\"none\"\n          }\n        ],\n        \"meta\":{\n          \"resourceType\":\"Schema\",\n          \"location\":\"https://instance.servicenow.com/api/now/scim/Schemas/urn:ietf:params:scim:schemas:custom:servicenow:2.0:Location\"\n        }\n      }\n    ],\n    \"startIndex\":1,\n  \"itemsPerPage\":8\n}\n```\n\n## SCIM - GET /scim/Schemas/\\{SchemaName\\}\n\nRetrieves information about the specified System for Cross-domain Identity Management \\(SCIM\\) resource schemas supported by a ServiceNow instance. These schemas define the attributes available for each resource type.\n\nThis is a public endpoint and does not require any roles to access.\n\n### URL format\n\nVersioned URL: `/api/now/{api_version}/scim/Schemas/{SchemaName}`\n\nDefault URL: `/api/now/scim/Schemas/{SchemaName}`\n\n**Note:** Available versions are specified in the [REST API Explorer](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/use-REST-API-Explorer.md). For scripted REST APIs there is additional version information on the [Scripted REST Service form](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_CustomWebServices.md).\n\n### Supported request parameters\n\n<table class=\"rest_api_path_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\napi\\_version\n\n</td><td id=\"version-entry-RESTAPI\">\n\nOptional. Version of the endpoint to access. For example, `v1` or `v2`. Only specify this value to use an endpoint version other than the latest. Data type: String\n\n</td></tr><tr><td>\n\nSchemaName\n\n</td><td>\n\nURI of the resource schema to return.Valid values:\n\n-   urn:ietf:params:scim:schemas:core:2.0:User\n-   urn:ietf:params:scim:schemas:extension: enterprise:2.0:User\n-   urn:ietf:params:scim:schemas:extension: servicenow:2.0:User\n-   urn:ietf:params:scim:schemas:core:2.0:Group\n-   urn:ietf:params:scim:schemas:custom: servicenow:2.0:Company\n-   urn:ietf:params:scim:schemas:custom: servicenow:2.0:Department\n-   urn:ietf:params:scim:schemas:custom: servicenow:2.0:CostCenter\n-   urn:ietf:params:scim:schemas:custom: servicenow:2.0:Location\n\n Data type: String\n\n</td></tr></tbody>\n</table>|Name|Description|\n|----|-----------|\n|None| |\n\n|Name|Description|\n|----|-----------|\n|None| |\n\n### Headers\n\nThe following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table class=\"rest_api_request_headers\"><thead><tr><th>\n\nHeader\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nAccept\n\n</td><td id=\"Accept-SCIM-entry\">\n\nData format of the response body. Supported types: **application/json** or **application/scim+json**.Default: **application/json**\n\n</td></tr></tbody>\n</table>|Header|Description|\n|------|-----------|\n|None| |\n\n### Status codes\n\nThe following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n|Status code|Description|\n|-----------|-----------|\n|200|Successful. The request was successfully processed.|\n|404|Not found. The requested item wasn't found.|\n\n### Response body parameters \\(JSON\\)\n\n|Name|Description|\n|----|-----------|\n|Standard RFC7643 return results|Method returns results in compliance with the RFC7643 standard. For details see [Schema Definition](https://datatracker.ietf.org/doc/html/rfc7643#section-7) in the RFC7643 specification.|\n\n### cURL request\n\nThe following example shows how to obtain the core Group SCIM schema from a ServiceNow instance.\n\n```\ncurl \"https://instance-servicenow.com/api/now/scim/Schemas/\"urn:ietf:params:scim:schemas:core:2.0:Group\" \\\n--request GET \\\n--header \"Accept:application/scim+json\" \\\n```\n\nResponse:\n\n```\n{\n  \"schemas\":[\n    \"urn:ietf:params:scim:schemas:core:2.0:Schema\"\n  ],\n  \"id\":\"urn:ietf:params:scim:schemas:core:2.0:Group\",\n  \"name\":\"Group\",\n  \"description\":\"Group\",\n  \"attributes\":[\n    {\n      \"name\":\"displayName\",\n      \"type\":\"string\",\n      \"multiValued\":false,\n      \"description\":\"A human-readable name for the Group.\",\n      \"required\":true,\n      \"caseExact\":false,\n      \"mutability\":\"readWrite\",\n      \"returned\":\"default\",\n      \"uniqueness\":\"none\"\n    },\n    {\n      \"name\":\"members\",\n      \"type\":\"complex\",\n      \"subAttributes\":[\n        {\n          \"name\":\"display\",\n          \"type\":\"string\",\n          \"multiValued\":false,\n          \"description\":\"A human readable name, primarily used for display purposes.\",\n          \"required\":false,\n          \"caseExact\":false,\n          \"mutability\":\"immutable\",\n          \"returned\":\"default\",\n          \"uniqueness\":\"none\"\n        },\n        {\n          \"name\":\"value\",\n          \"type\":\"string\",\n          \"multiValued\":false,\n          \"description\":\"The identifier of a group member.\",\n          \"required\":true,\n          \"caseExact\":false,\n          \"mutability\":\"immutable\",\n          \"returned\":\"default\",\n          \"uniqueness\":\"none\"\n        },\n        {\n          \"name\":\"$ref\",\n          \"type\":\"reference\",\n          \"multiValued\":false,\n          \"description\":\"The URI of the member resource.\",\n          \"required\":false,\n          \"caseExact\":true,\n          \"mutability\":\"immutable\",\n          \"returned\":\"default\",\n          \"uniqueness\":\"none\",\n          \"referenceTypes\":[\"Group\",\"User\"]\n        }\n      ],\n      \"multiValued\":true,\n      \"description\":\"A list of members of the Group.\",\n      \"required\":false,\n      \"caseExact\":true,\n      \"mutability\":\"readWrite\",\n      \"returned\":\"default\",\n      \"uniqueness\":\"none\"\n    }\n  ],\n  \"meta\":{\n    \"resourceType\":\"Schema\",\n    \"location\":\"https://instance-servicenow.com/api/now/scim/Schemas/urn:ietf:params:scim:schemas:core:2.0:Group\"\n  }\n}\n```\n\n## SCIM - GET /scim/ServiceProviderConfig\n\nReturns the configuration metadata to use to obtain information about the service capabilities, configurations, schemas, and resource types for the System for Cross-domain Identity Management \\(SCIM\\) endpoints available within a ServiceNow instance.\n\nThis is a public endpoint and does not require any roles to access.\n\n### URL format\n\nVersioned URL: `/api/now/{api_version}/scim/ServiceProviderConfig`\n\nDefault URL: `/api/now/scim/ServiceProviderConfig`\n\n**Note:** Available versions are specified in the [REST API Explorer](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/use-REST-API-Explorer.md). For scripted REST APIs there is additional version information on the [Scripted REST Service form](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_CustomWebServices.md).\n\n### Supported request parameters\n\n<table class=\"rest_api_path_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\napi\\_version\n\n</td><td id=\"version-entry-RESTAPI\">\n\nOptional. Version of the endpoint to access. For example, `v1` or `v2`. Only specify this value to use an endpoint version other than the latest. Data type: String\n\n</td></tr></tbody>\n</table>|Name|Description|\n|----|-----------|\n|None| |\n\n|Name|Description|\n|----|-----------|\n|None| |\n\n### Headers\n\nThe following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table class=\"rest_api_request_headers\"><thead><tr><th>\n\nHeader\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nAccept\n\n</td><td id=\"Accept-SCIM-entry\">\n\nData format of the response body. Supported types: **application/json** or **application/scim+json**.Default: **application/json**\n\n</td></tr></tbody>\n</table>|Header|Description|\n|------|-----------|\n|None| |\n\n### Status codes\n\nThe following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n|Status code|Description|\n|-----------|-----------|\n|200|Successful. The request was successfully processed.|\n\n### Response body parameters \\(JSON\\)\n\n|Name|Description|\n|----|-----------|\n|Standard RFC7643 return results|Method returns results in compliance with the RFC7643 standard. For details see [Service Provider Configuration Schema](https://datatracker.ietf.org/doc/html/rfc7643#section-5) in the RFC7643 specification.|\n\n### cURL request\n\nThe following example shows how to obtain the SCIM configuration metadata for a ServiceNow instance.\n\n```\ncurl \"https://instance-servicenow.com/api/now/scim/ServiceProviderConfig \\\n--request GET \\\n--header \"Accept:application/scim+json\" \\\n```\n\nResponse:\n\n```\n{\n  \"schemas\": [\n    \"urn:ietf:params:scim:schemas:core:2.0:ServiceProviderConfig\"\n  ],\n  \"patch\": {\n    \"supported\": true\n  },\n  \"bulk\": {\n    \"supported\": false,\n    \"maxOperations\": 0,\n    \"maxPayloadSize\": 1000000\n  },\n  \"filter\": {\n    \"supported\": true,\n    \"maxResults\": 500\n  },\n  \"changePassword\": {\n    \"supported\": false\n  },\n  \"sort\": {\n    \"supported\": false\n  },\n  \"etag\": {\n    \"supported\": false\n  },\n  \"authenticationSchemes\": [\n    {\n      \"name\": \"OAuth 2.0 Bearer Token\",\n      \"description\": \"The OAuth 2.0 Bearer Token Authentication scheme. OAuth\n        enables clients to access protected resources by obtaining an access token, which is\n        defined in RFC 6750 as \\\"a string representing an access authorization issued to the\n        client\\\", rather than using the resource owner's credentials directly.\",\n      \"specUri\": \"http://tools.ietf.org/html/rfc6750\",\n      \"type\": \"oauthbearertoken\",\n      \"primary\": true\n    }\n  ]\n}\n```\n\n## SCIM - GET /scim/Companies\n\nReturns one or more company records from the Company \\[core\\_company\\] table within a ServiceNow instance using the System for Cross-domain Identity Management \\(SCIM\\) protocol.\n\n**Note:** A query that does not return any matches returns success \\(HTTP status code 200\\) with **totalResults** set to 0.\n\n### URL format\n\nVersioned URL: `/api/now/{api_version}/scim/Companies`\n\nDefault URL: `/api/now/scim/Companies`\n\n**Note:** Available versions are specified in the [REST API Explorer](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/use-REST-API-Explorer.md). For scripted REST APIs there is additional version information on the [Scripted REST Service form](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_CustomWebServices.md).\n\n### Supported request parameters\n\n<table class=\"rest_api_path_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\napi\\_version\n\n</td><td id=\"version-entry-RESTAPI\">\n\nOptional. Version of the endpoint to access. For example, `v1` or `v2`. Only specify this value to use an endpoint version other than the latest. Data type: String\n\n</td></tr></tbody>\n</table><table class=\"rest_api_query_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nattributes\n\n</td><td id=\"attributes-SCIM-entry\">\n\nComma-separated list of fields to return in the response. No other fields are returned.Can't be used with the **excludedAttributes** parameter.\n\nData type: String\n\nDefault: Return all fields unless **excludedAttributes** is specified.\n\n</td></tr><tr><td>\n\ncount\n\n</td><td id=\"count-SCIM-entry\">\n\nNumber of records to return. A negative value is interpreted as zero.Data type: Number\n\nMaximum: 500 - A value greater than this results in a bad request error.\n\nDefault: 10\n\n</td></tr><tr><td>\n\nexcludedAttributes\n\n</td><td id=\"excludedAttributes-SCIM-entry\">\n\nComma-separated list of fields to exclude from the records returned in the response. All other fields are returned.Can't be used with the **attributes** parameter.\n\nData type: String\n\nDefault: Do not exclude any fields.\n\n</td></tr><tr><td>\n\nfilter\n\n</td><td>\n\nFilter expression to apply to the return results. Field filters are expressed as `<field_name> <operator> <\"value\">`. Refer to [RFC7644](https://datatracker.ietf.org/doc/html/rfc7644#section-3.4.2) for a list of the valid operators. **Note:** The `NOT` operator is not supported by this method.\n\n For example, to filter for all companies whose name starts with \"Acme\", enter `displayName SW \"Acme\"`.\n\n To specify more than one field filter, concatenate the filters using the `AND` operand. For example, to filter for all companies whose name starts with \"Acme\" and were last modified before October 3, 2021, enter `displayName SW \"Acme\" AND meta.lastModified lt \"2021-10-03T00:00:00Z\"`. Use dot-walking to specify nested attributes.\n\n Data type: String\n\n Default: No filtering\n\n</td></tr><tr><td>\n\nsortBy\n\n</td><td id=\"group_sortBy-SCIM-entry\">\n\nMust be specified with the **sortOrder** parameter. Field by which to sort the return results. Sorting is case-insensitive. You can only use those parameters available for filtering for the **sortBy** parameter, except that **externalId** is not allowed.\n\nFor values that are null:\n\n-   sorted by ascending: Null values are sorted to the top.\n-   sorted by descending: Null values are sorted to the bottom.\n\nData type: String\n\nDefault: No sort\n\n</td></tr><tr><td>\n\nsortOrder\n\n</td><td id=\"sortOrder-SCIM-entry\">\n\nMust be specified with the **sortBy** parameter. Order in which the **sortBy** parameter is applied to the return results. Valid values:\n\n-   ascending\n-   descending\n\nData type: String\n\nDefault: ascending\n\n</td></tr><tr><td>\n\nstartIndex\n\n</td><td id=\"group_startIndex-SCIM-entry\">\n\nOne-based index into the table at which to start retrieving records. For example, if you set this parameter to 100, and the **count** parameter to 20, the endpoint returns records 100 through 119. **Note:** Any value that is set to less than one is interpreted as one.\n\nData type: String\n\nDefault: 1\n\n</td></tr></tbody>\n</table>|Name|Description|\n|----|-----------|\n|None| |\n\n### Headers\n\nThe following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table class=\"rest_api_request_headers\"><thead><tr><th>\n\nHeader\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nAccept\n\n</td><td id=\"Accept-SCIM-entry\">\n\nData format of the response body. Supported types: **application/json** or **application/scim+json**.Default: **application/json**\n\n</td></tr></tbody>\n</table>|Header|Description|\n|------|-----------|\n|None| |\n\n### Status codes\n\nThe following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table><thead><tr><th>\n\nStatus code\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\n200\n\n</td><td id=\"entry-200-status-code\">\n\nSuccessful. The request was successfully processed.\n\n</td></tr><tr><td>\n\n400\n\n</td><td id=\"status_400-SCIM-entry\">\n\nBad Request. A bad request type or malformed request was detected.-   Ensure that both the **attributes** and **excludedAttributes** query parameters have not been passed in the request.\n-   Ensure that the **count** parameter is not greater than 500.\n-   Ensure that all **filter** parameters are valid.\n\n</td></tr><tr><td>\n\n401\n\n</td><td id=\"entry-401-status-code\">\n\nUnauthorized. The user credentials are incorrect or have not been passed.\n\n</td></tr></tbody>\n</table>### Response body parameters \\(JSON\\)\n\n<table id=\"id_uwg_55q_3rb\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nitemsPerPage\n\n</td><td id=\"itemsPerPage-SCIM-entry\">\n\nNumber of records returned in the return results.Data type: Number\n\n</td></tr><tr><td>\n\nResources\n\n</td><td>\n\nList of returned cost center records.Data type: Object\n\n ```\n\"Resources\": {\n  \"id\": \"String\",\n  \"meta\": {Object},\n  \"name\": \"String\",\n  \"schemas\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nResources.id\n\n</td><td>\n\nSys\\_id of the company record.Data type: String\n\n</td></tr><tr><td>\n\nResources.meta\n\n</td><td>\n\nInformation pertaining to the company record.Data type: Object\n\n```\n\"meta\": {\n  \"created\": \"String\",\n  \"lastModified\": \"String\",\n  \"location\": \"String\",\n  \"resourcType\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nResources.meta.created\n\n</td><td>\n\nDate and time the associated company record was created.Data type: String\n\n</td></tr><tr><td>\n\nResources.meta.lastModified\n\n</td><td>\n\nDate and time the associated company record was last modified.Data type: String\n\n</td></tr><tr><td>\n\nResources.meta.location\n\n</td><td>\n\nURI of the associated company record.Data type: String\n\n</td></tr><tr><td>\n\nResources.meta.resourceType\n\n</td><td>\n\nSCIM resource type; always Company.Data type: String\n\n</td></tr><tr><td>\n\nResources.name\n\n</td><td>\n\nCompany name.Data type: String\n\n</td></tr><tr><td>\n\nResources.schemas\n\n</td><td>\n\nSchema used when processing the request.Data type: String\n\n</td></tr><tr><td>\n\nschemas\n\n</td><td>\n\nSchema used to process the list response to the request. For example: `\"urn:ietf:params:scim:api:messages:2.0:ListResponse\"` Data type: String\n\n</td></tr><tr><td>\n\nstartIndex\n\n</td><td>\n\nOne-based index into the Company \\[core\\_company\\] table at which the records were returned.Data type: String\n\n</td></tr><tr><td>\n\ntotalResults\n\n</td><td id=\"totalResults-SCIM-entry\">\n\nTotal number of records that match the request.Data type: Number\n\n</td></tr></tbody>\n</table>### cURL request\n\nThis example shows how to retrieve the first two company records.\n\n```\ncurl \"https://instance-servicenow.com/api/now/scim/Companies?count=2\" \\\n--request GET \\\n--header \"Accept:application/scim+json\" \\\n```\n\nResponse:\n\n```\n{\n  \"schemas\":[\n    \"urn:ietf:params:scim:api:messages:2.0:ListResponse\"\n  ],\n  \"totalResults\":182,\n  \"Resources\":[\n    {\n      \"schemas\":[\n        \"urn:ietf:params:scim:schemas:custom:servicenow:2.0:Company\"\n      ],\n      \"id\":\"0c43af40c6112275011a4bd4c0143fbf\",\n      \"meta\":{\n        \"resourceType\":\"Company\",\n        \"created\":\"2005-05-24T01:14:19Z\",\n        \"lastModified\":\"2013-05-06T23:44:48Z\",\n        \"location\":\"https://instance-servicenow.com/api/now/scim/Companies/0c43af40c6112275011a4bd4c0143fbf\"\n      },\n      \"name\":\"ABC Company\"\n    },\n    {\n      \"schemas\":[\n        \"urn:ietf:params:scim:schemas:custom:servicenow:2.0:Company\"\n      ],\n      \"id\":\"0c43b088c6112275011a4bd46a4e6cc4\",\n      \"meta\":{\n        \"resourceType\":\"Company\",\n        \"created\":\"2005-05-24T01:14:19Z\",\n        \"lastModified\":\"2013-06-05T17:53:26Z\",\n        \"location\":\"https://instance-servicenow.com/api/now/scim/Companies/0c43b088c6112275011a4bd46a4e6cc4\"\n      },\n      \"name\":\"Acme Co\"\n    }\n  ],\n  \"startIndex\":1,\n  \"itemsPerPage\":2\n}\n```\n\n## SCIM - GET /scim/Companies/\\{company\\_id\\}\n\nReturns the specified company record from the Company \\[core\\_company\\] table within a ServiceNow instance using the System for Cross-domain Identity Management \\(SCIM\\) protocol.\n\n### URL format\n\nVersioned URL: `/api/now/{api_version}/scim/Companies/{company_id}`\n\nDefault URL: `/api/now/scim/Groups/{company_id}`\n\n**Note:** Available versions are specified in the [REST API Explorer](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/use-REST-API-Explorer.md). For scripted REST APIs there is additional version information on the [Scripted REST Service form](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_CustomWebServices.md).\n\n### Supported request parameters\n\n<table class=\"rest_api_path_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\napi\\_version\n\n</td><td id=\"version-entry-RESTAPI\">\n\nOptional. Version of the endpoint to access. For example, `v1` or `v2`. Only specify this value to use an endpoint version other than the latest. Data type: String\n\n</td></tr><tr><td>\n\ncompany\\_id\n\n</td><td>\n\nSys\\_id of the company record to return.Data type: String\n\n</td></tr></tbody>\n</table><table class=\"rest_api_query_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nattributes\n\n</td><td id=\"attributes-SCIM-entry\">\n\nComma-separated list of fields to return in the response. No other fields are returned.Can't be used with the **excludedAttributes** parameter.\n\nData type: String\n\nDefault: Return all fields unless **excludedAttributes** is specified.\n\n</td></tr><tr><td>\n\nexcludedAttributes\n\n</td><td id=\"excludedAttributes-SCIM-entry\">\n\nComma-separated list of fields to exclude from the records returned in the response. All other fields are returned.Can't be used with the **attributes** parameter.\n\nData type: String\n\nDefault: Do not exclude any fields.\n\n</td></tr></tbody>\n</table>|Name|Description|\n|----|-----------|\n|None| |\n\n### Headers\n\nThe following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table class=\"rest_api_request_headers\"><thead><tr><th>\n\nHeader\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nAccept\n\n</td><td id=\"Accept-SCIM-entry\">\n\nData format of the response body. Supported types: **application/json** or **application/scim+json**.Default: **application/json**\n\n</td></tr></tbody>\n</table>|Header|Description|\n|------|-----------|\n|None| |\n\n### Status codes\n\nThe following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table><thead><tr><th>\n\nStatus code\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\n200\n\n</td><td id=\"entry-200-status-code\">\n\nSuccessful. The request was successfully processed.\n\n</td></tr><tr><td>\n\n400\n\n</td><td id=\"status_400-SCIM-entry\">\n\nBad Request. A bad request type or malformed request was detected.-   Ensure that both the **attributes** and **excludedAttributes** query parameters have not been passed in the request.\n-   Ensure that the **count** parameter is not greater than 500.\n-   Ensure that all **filter** parameters are valid.\n\n</td></tr><tr><td>\n\n401\n\n</td><td id=\"entry-401-status-code\">\n\nUnauthorized. The user credentials are incorrect or have not been passed.\n\n</td></tr><tr><td>\n\n404\n\n</td><td id=\"entry-404-status-code\">\n\nNot found. The requested item wasn't found.\n\n</td></tr></tbody>\n</table>### Response body parameters \\(JSON\\)\n\n<table id=\"id_mvt_mbq_3rb\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nid\n\n</td><td id=\"id-company-SCIM-entry\">\n\nSys\\_id of the company record.Data type: String\n\n</td></tr><tr><td>\n\nmeta\n\n</td><td id=\"meta-company-SCIM-entry\">\n\nInformation pertaining to the company record.Data type: Object\n\n```\n\"meta\": {\n  \"created\": \"String\",\n  \"lastModified\": \"String\",\n  \"location\": \"String\",\n  \"resourcType\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nmeta.created\n\n</td><td id=\"meta_created-company-SCIM-entry\">\n\nDate and time the associated company record was created.Data type: String\n\n</td></tr><tr><td>\n\nmeta.lastModified\n\n</td><td id=\"meta_lastModified-company-SCIM-entry\">\n\nDate and time the associated company record was last modified.Data type: String\n\n</td></tr><tr><td>\n\nmeta.location\n\n</td><td id=\"meta_location-company-SCIM-entry\">\n\nURI of the associated company record.Data type: String\n\n</td></tr><tr><td>\n\nmeta.resourceType\n\n</td><td id=\"meta_resourceType-company-SCIM-entry\">\n\nSCIM resource type; always Company.Data type: String\n\n</td></tr><tr><td>\n\nname\n\n</td><td id=\"name-company-SCIM-entry\">\n\nCompany name.Data type: String\n\n</td></tr><tr><td>\n\nschemas\n\n</td><td id=\"schemas-company-SCIM-entry\">\n\nSchema used when processing the request.Data type: String\n\n</td></tr></tbody>\n</table>### cURL request\n\nThis example shows how to retrieve a specific company record.\n\n```\ncurl \"https://instance-servicenow.com/api/now/scim/Companies/0c43af40c6112275011a4bd4c0143fbf\" \\\n--request GET \\\n--header \"Accept:application/scim+json\" \\\n```\n\nResponse\n\n```\n{\n  \"schemas\":[\n    \"urn:ietf:params:scim:schemas:custom:servicenow:2.0:Company\"\n  ],\n  \"id\":\"0c43af40c6112275011a4bd4c0143fbf\",\n  \"meta\":{\n    \"resourceType\":\"Company\",\n    \"created\":\"2005-05-24T01:14:19Z\",\n    \"lastModified\":\"2013-05-06T23:44:48Z\",\n    \"location\":\"https://instance-servicenow.com/api/now/scim/Companies/0c43af40c6112275011a4bd4c0143fbf\"\n  },\n  \"name\":\"ABC Company\"\n}\n```\n\n## SCIM - GET /scim/CostCenters\n\nReturns one or more cost center records from the Cost Center \\[cmn\\_cost\\_center\\] table within a ServiceNow instance using the System for Cross-domain Identity Management \\(SCIM\\) protocol.\n\n**Note:** A query that does not return any matches returns success \\(HTTP status code 200\\) with **totalResults** set to 0.\n\n### URL format\n\nVersioned URL: `/api/now/{api_version}/scim/CostCenters`\n\nDefault URL: `/api/now/scim/CostCenters`\n\n**Note:** Available versions are specified in the [REST API Explorer](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/use-REST-API-Explorer.md). For scripted REST APIs there is additional version information on the [Scripted REST Service form](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_CustomWebServices.md).\n\n### Supported request parameters\n\n<table class=\"rest_api_path_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\napi\\_version\n\n</td><td id=\"version-entry-RESTAPI\">\n\nOptional. Version of the endpoint to access. For example, `v1` or `v2`. Only specify this value to use an endpoint version other than the latest. Data type: String\n\n</td></tr></tbody>\n</table><table class=\"rest_api_query_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nattributes\n\n</td><td id=\"attributes-SCIM-entry\">\n\nComma-separated list of fields to return in the response. No other fields are returned.Can't be used with the **excludedAttributes** parameter.\n\nData type: String\n\nDefault: Return all fields unless **excludedAttributes** is specified.\n\n</td></tr><tr><td>\n\ncount\n\n</td><td id=\"count-SCIM-entry\">\n\nNumber of records to return. A negative value is interpreted as zero.Data type: Number\n\nMaximum: 500 - A value greater than this results in a bad request error.\n\nDefault: 10\n\n</td></tr><tr><td>\n\nexcludedAttributes\n\n</td><td id=\"excludedAttributes-SCIM-entry\">\n\nComma-separated list of fields to exclude from the records returned in the response. All other fields are returned.Can't be used with the **attributes** parameter.\n\nData type: String\n\nDefault: Do not exclude any fields.\n\n</td></tr><tr><td>\n\nfilter\n\n</td><td>\n\nFilter expression to apply to the return results. Field filters are expressed as `<field_name> <operator> <\"value\">`. Refer to [RFC7644](https://datatracker.ietf.org/doc/html/rfc7644#section-3.4.2) for a list of the valid operators. **Note:** The `NOT` operator is not supported by this method.\n\n For example, to filter for all cost center whose name starts with \"HR\", enter `displayName SW \"HR\"`.\n\n To specify more than one field filter, concatenate the filters using the `AND` operand. For example, to filter for all cost center whose name starts with \"HR\" and were last modified before October 3, 2021, enter `displayName SW \"HR\" AND meta.lastModified lt \"2021-10-03T00:00:00Z\"`. Use dot-walking to specify nested attributes.\n\n Data type: String\n\n Default: No filtering\n\n</td></tr><tr><td>\n\nsortBy\n\n</td><td id=\"group_sortBy-SCIM-entry\">\n\nMust be specified with the **sortOrder** parameter. Field by which to sort the return results. Sorting is case-insensitive. You can only use those parameters available for filtering for the **sortBy** parameter, except that **externalId** is not allowed.\n\nFor values that are null:\n\n-   sorted by ascending: Null values are sorted to the top.\n-   sorted by descending: Null values are sorted to the bottom.\n\nData type: String\n\nDefault: No sort\n\n</td></tr><tr><td>\n\nsortOrder\n\n</td><td id=\"sortOrder-SCIM-entry\">\n\nMust be specified with the **sortBy** parameter. Order in which the **sortBy** parameter is applied to the return results. Valid values:\n\n-   ascending\n-   descending\n\nData type: String\n\nDefault: ascending\n\n</td></tr><tr><td>\n\nstartIndex\n\n</td><td id=\"group_startIndex-SCIM-entry\">\n\nOne-based index into the table at which to start retrieving records. For example, if you set this parameter to 100, and the **count** parameter to 20, the endpoint returns records 100 through 119. **Note:** Any value that is set to less than one is interpreted as one.\n\nData type: String\n\nDefault: 1\n\n</td></tr></tbody>\n</table>|Name|Description|\n|----|-----------|\n|None| |\n\n### Headers\n\nThe following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table class=\"rest_api_request_headers\"><thead><tr><th>\n\nHeader\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nAccept\n\n</td><td id=\"Accept-SCIM-entry\">\n\nData format of the response body. Supported types: **application/json** or **application/scim+json**.Default: **application/json**\n\n</td></tr></tbody>\n</table>|Header|Description|\n|------|-----------|\n|None| |\n\n### Status codes\n\nThe following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table><thead><tr><th>\n\nStatus code\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\n200\n\n</td><td id=\"entry-200-status-code\">\n\nSuccessful. The request was successfully processed.\n\n</td></tr><tr><td>\n\n400\n\n</td><td id=\"status_400-SCIM-entry\">\n\nBad Request. A bad request type or malformed request was detected.-   Ensure that both the **attributes** and **excludedAttributes** query parameters have not been passed in the request.\n-   Ensure that the **count** parameter is not greater than 500.\n-   Ensure that all **filter** parameters are valid.\n\n</td></tr><tr><td>\n\n401\n\n</td><td id=\"entry-401-status-code\">\n\nUnauthorized. The user credentials are incorrect or have not been passed.\n\n</td></tr></tbody>\n</table>### Response body parameters \\(JSON\\)\n\n<table id=\"id_tld_hxq_3rb\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nitemsPerPage\n\n</td><td id=\"itemsPerPage-SCIM-entry\">\n\nNumber of records returned in the return results.Data type: Number\n\n</td></tr><tr><td>\n\nResources\n\n</td><td>\n\nList of returned cost center records.Data type: Object\n\n ```\n\"Resources\": {\n  \"id\": \"String\",\n  \"meta\": {Object},\n  \"name\": \"String\",\n  \"schemas\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nResources.id\n\n</td><td>\n\nSys\\_id of the cost center record.Data type: String\n\n</td></tr><tr><td>\n\nResources.meta\n\n</td><td>\n\nInformation pertaining to the cost center record.Data type: Object\n\n```\n\"meta\": {\n  \"created\": \"String\",\n  \"lastModified\": \"String\",\n  \"location\": \"String\",\n  \"resourcType\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nResources.meta.created\n\n</td><td>\n\nDate and time the associated cost center record was created.Data type: String\n\n</td></tr><tr><td>\n\nResources.meta.lastModified\n\n</td><td>\n\nDate and time the associated cost center record was last modified.Data type: String\n\n</td></tr><tr><td>\n\nResources.meta.location\n\n</td><td>\n\nURI of the associated cost center record.Data type: String\n\n</td></tr><tr><td>\n\nResources.meta.resourceType\n\n</td><td>\n\nSCIM resource type; always CostCenter.Data type: String\n\n</td></tr><tr><td>\n\nResources.name\n\n</td><td>\n\nCost center name.Data type: String\n\n</td></tr><tr><td>\n\nResources.schemas\n\n</td><td>\n\nSchema used when processing the request.Data type: String\n\n</td></tr><tr><td>\n\nschemas\n\n</td><td>\n\nSchema used to process the list response to the request. For example: `\"urn:ietf:params:scim:api:messages:2.0:ListResponse\"` Data type: String\n\n</td></tr><tr><td>\n\nstartIndex\n\n</td><td>\n\nOne-based index into the Cost Center \\[cmn\\_cost\\_center\\] table at which the records were returned.Data type: String\n\n</td></tr><tr><td>\n\ntotalResults\n\n</td><td id=\"totalResults-SCIM-entry\">\n\nTotal number of records that match the request.Data type: Number\n\n</td></tr></tbody>\n</table>### cURL request\n\nThis example shows how to retrieve the first two cost center records.\n\n```\ncurl \"https://instance-servicenow.com/api/now/scim/CostCenters?count=2\" \\\n--request GET \\\n--header \"Accept:application/scim+json\" \\\n```\n\nResponse:\n\n```\n{\n  \"schemas\":[\n    \"urn:ietf:params:scim:api:messages:2.0:ListResponse\"\n  ],\n  \"totalResults\":8,\n  \"Resources\":[\n    {\n      \"schemas\":[\n        \"urn:ietf:params:scim:schemas:custom:servicenow:2.0:CostCenter\"\n      ],\n      \"id\":\"7fb1cc99c0a80a6d30c04574d14c0acf\",\n      \"meta\":{\n        \"resourceType\":\"CostCenter\",\n        \"created\":\"2012-01-19T21:02:39Z\",\n        \"lastModified\":\"2012-02-25T23:06:36Z\",\n        \"location\":\"https://instance-servicenow.com/api/now/scim/CostCenters/7fb1cc99c0a80a6d30c04574d14c0acf\"\n      },\n      \"name\":\"Sales\"\n    },\n    {\n      \"schemas\":[\n        \"urn:ietf:params:scim:schemas:custom:servicenow:2.0:CostCenter\"\n      ],\n      \"id\":\"91e8bbf43710200044e0bfc8bcbe5daa\",\n      \"meta\":{\n        \"resourceType\":\"CostCenter\",\n        \"created\":\"2012-02-18T04:40:24Z\",\n        \"lastModified\":\"2012-02-25T23:05:58Z\",\n        \"location\":\"https://instance-servicenow.com/api/now/scim/CostCenters/91e8bbf43710200044e0bfc8bcbe5daa\"\n      },\n      \"name\":\"Customer Support\"\n    }\n  ],\n  \"startIndex\":1,\n  \"itemsPerPage\":2\n}\n```\n\n## SCIM - GET /scim/CostCenters/\\{cost\\_center\\_id\\}\n\nReturns the specified cost center record from the Cost Center \\[cmn\\_cost\\_center\\] table within a ServiceNow instance using the System for Cross-domain Identity Management \\(SCIM\\) protocol.\n\n**Note:** A query that does not return any matches returns success \\(HTTP status code 200\\) with **totalResults** set to 0.\n\n### URL format\n\nVersioned URL: `/api/now/{api_version}/scim/CostCenters/{cost_center_id}`\n\nDefault URL: `/api/now/scim/CoostCenters/{cost_center_id}`\n\n**Note:** Available versions are specified in the [REST API Explorer](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/use-REST-API-Explorer.md). For scripted REST APIs there is additional version information on the [Scripted REST Service form](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_CustomWebServices.md).\n\n### Supported request parameters\n\n<table class=\"rest_api_path_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\napi\\_version\n\n</td><td id=\"version-entry-RESTAPI\">\n\nOptional. Version of the endpoint to access. For example, `v1` or `v2`. Only specify this value to use an endpoint version other than the latest. Data type: String\n\n</td></tr><tr><td>\n\ncost\\_center\\_id\n\n</td><td>\n\nSys\\_id of the cost center record to return.Data type: String\n\n</td></tr></tbody>\n</table><table class=\"rest_api_query_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nattributes\n\n</td><td id=\"attributes-SCIM-entry\">\n\nComma-separated list of fields to return in the response. No other fields are returned.Can't be used with the **excludedAttributes** parameter.\n\nData type: String\n\nDefault: Return all fields unless **excludedAttributes** is specified.\n\n</td></tr><tr><td>\n\nexcludedAttributes\n\n</td><td id=\"excludedAttributes-SCIM-entry\">\n\nComma-separated list of fields to exclude from the records returned in the response. All other fields are returned.Can't be used with the **attributes** parameter.\n\nData type: String\n\nDefault: Do not exclude any fields.\n\n</td></tr></tbody>\n</table>|Name|Description|\n|----|-----------|\n|None| |\n\n### Headers\n\nThe following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table class=\"rest_api_request_headers\"><thead><tr><th>\n\nHeader\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nAccept\n\n</td><td id=\"Accept-SCIM-entry\">\n\nData format of the response body. Supported types: **application/json** or **application/scim+json**.Default: **application/json**\n\n</td></tr></tbody>\n</table>|Header|Description|\n|------|-----------|\n|None| |\n\n### Status codes\n\nThe following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table><thead><tr><th>\n\nStatus code\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\n200\n\n</td><td id=\"entry-200-status-code\">\n\nSuccessful. The request was successfully processed.\n\n</td></tr><tr><td>\n\n400\n\n</td><td id=\"status_400-SCIM-entry\">\n\nBad Request. A bad request type or malformed request was detected.-   Ensure that both the **attributes** and **excludedAttributes** query parameters have not been passed in the request.\n-   Ensure that the **count** parameter is not greater than 500.\n-   Ensure that all **filter** parameters are valid.\n\n</td></tr><tr><td>\n\n401\n\n</td><td id=\"entry-401-status-code\">\n\nUnauthorized. The user credentials are incorrect or have not been passed.\n\n</td></tr><tr><td>\n\n404\n\n</td><td id=\"entry-404-status-code\">\n\nNot found. The requested item wasn't found.\n\n</td></tr></tbody>\n</table>### Response body parameters \\(JSON\\)\n\n<table id=\"id_tld_hxq_3rb\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nid\n\n</td><td id=\"id-costcenter-SCIM-entry\">\n\nSys\\_id of the cost center record.Data type: String\n\n</td></tr><tr><td>\n\nmeta\n\n</td><td id=\"meta-costcenter-SCIM-entry\">\n\nInformation pertaining to the cost center record.Data type: Object\n\n```\n\"meta\": {\n  \"created\": \"String\",\n  \"lastModified\": \"String\",\n  \"location\": \"String\",\n  \"resourcType\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nmeta.created\n\n</td><td id=\"meta_created-costcenter-SCIM-entry\">\n\nDate and time the associated cost center record was created.Data type: String\n\n</td></tr><tr><td>\n\nmeta.lastModified\n\n</td><td id=\"meta_lastModified-costcenter-SCIM-entry\">\n\nDate and time the associated cost center record was last modified.Data type: String\n\n</td></tr><tr><td>\n\nmeta.location\n\n</td><td id=\"meta_location-costcenter-SCIM-entry\">\n\nURI of the associated cost center record.Data type: String\n\n</td></tr><tr><td>\n\nmeta.resourceType\n\n</td><td id=\"meta_resourceType-costcenter-SCIM-entry\">\n\nSCIM resource type; always CostCenter.Data type: String\n\n</td></tr><tr><td>\n\nname\n\n</td><td id=\"name-costcenter-SCIM-entry\">\n\nCost center name.Data type: String\n\n</td></tr><tr><td>\n\nschemas\n\n</td><td id=\"schemas-costcenter-SCIM-entry\">\n\nSchema used when processing the request.Data type: String\n\n</td></tr></tbody>\n</table>### cURL request\n\nThis example shows how to retrieve a specific cost center record.\n\n```\ncurl \"https://instance-servicenow.com/api/now/scim/CostCenters/7fb1cc99c0a80a6d30c04574d14c0acf\" \\\n--request GET \\\n--header \"Accept:application/scim+json\" \\\n```\n\nResponse:\n\n```\n{\n  \"schemas\":[\n    \"urn:ietf:params:scim:schemas:custom:servicenow:2.0:CostCenter\"\n  ],\n  \"id\":\"7fb1cc99c0a80a6d30c04574d14c0acf\",\n  \"meta\":{\n    \"resourceType\":\"CostCenter\",\n    \"created\":\"2012-01-19T21:02:39Z\",\n    \"lastModified\":\"2012-02-25T23:06:36Z\",\n    \"location\":\"https://instance-servicenow.com/api/now/scim/CostCenters/7fb1cc99c0a80a6d30c04574d14c0acf\"\n  },\n  \"name\":\"Sales\"\n}\n```\n\n## SCIM - GET /scim/Departments\n\nReturns one or more department records from the Department \\[cmn\\_department\\] table within a ServiceNow instance using the System for Cross-domain Identity Management \\(SCIM\\) protocol.\n\n**Note:** A query that does not return any matches returns success \\(HTTP status code 200\\) with **totalResults** set to 0.\n\n### URL format\n\nVersioned URL: `/api/now/{api_version}/scim/Departments`\n\nDefault URL: `/api/now/scim/Departments`\n\n**Note:** Available versions are specified in the [REST API Explorer](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/use-REST-API-Explorer.md). For scripted REST APIs there is additional version information on the [Scripted REST Service form](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_CustomWebServices.md).\n\n### Supported request parameters\n\n<table class=\"rest_api_path_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\napi\\_version\n\n</td><td id=\"version-entry-RESTAPI\">\n\nOptional. Version of the endpoint to access. For example, `v1` or `v2`. Only specify this value to use an endpoint version other than the latest. Data type: String\n\n</td></tr></tbody>\n</table><table class=\"rest_api_query_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nattributes\n\n</td><td id=\"attributes-SCIM-entry\">\n\nComma-separated list of fields to return in the response. No other fields are returned.Can't be used with the **excludedAttributes** parameter.\n\nData type: String\n\nDefault: Return all fields unless **excludedAttributes** is specified.\n\n</td></tr><tr><td>\n\ncount\n\n</td><td id=\"count-SCIM-entry\">\n\nNumber of records to return. A negative value is interpreted as zero.Data type: Number\n\nMaximum: 500 - A value greater than this results in a bad request error.\n\nDefault: 10\n\n</td></tr><tr><td>\n\nexcludedAttributes\n\n</td><td id=\"excludedAttributes-SCIM-entry\">\n\nComma-separated list of fields to exclude from the records returned in the response. All other fields are returned.Can't be used with the **attributes** parameter.\n\nData type: String\n\nDefault: Do not exclude any fields.\n\n</td></tr><tr><td>\n\nfilter\n\n</td><td>\n\nFilter expression to apply to the return results. Field filters are expressed as `<field_name> <operator> <\"value\">`. Refer to [RFC7644](https://datatracker.ietf.org/doc/html/rfc7644#section-3.4.2) for a list of the valid operators. **Note:** The `NOT` operator is not supported by this method.\n\n For example, to filter for all departments whose name starts with \"Engineer\", enter `displayName SW \"Engineer\"`.\n\n To specify more than one field filter, concatenate the filters using the `AND` operand. For example, to filter for all departments whose name starts with \"Engineer\" and were last modified before October 3, 2021, enter `displayName SW \"Engineer\" AND meta.lastModified lt \"2021-10-03T00:00:00Z\"`. Use dot-walking to specify nested attributes.\n\n Data type: String\n\n Default: No filtering\n\n</td></tr><tr><td>\n\nsortBy\n\n</td><td id=\"group_sortBy-SCIM-entry\">\n\nMust be specified with the **sortOrder** parameter. Field by which to sort the return results. Sorting is case-insensitive. You can only use those parameters available for filtering for the **sortBy** parameter, except that **externalId** is not allowed.\n\nFor values that are null:\n\n-   sorted by ascending: Null values are sorted to the top.\n-   sorted by descending: Null values are sorted to the bottom.\n\nData type: String\n\nDefault: No sort\n\n</td></tr><tr><td>\n\nsortOrder\n\n</td><td id=\"sortOrder-SCIM-entry\">\n\nMust be specified with the **sortBy** parameter. Order in which the **sortBy** parameter is applied to the return results. Valid values:\n\n-   ascending\n-   descending\n\nData type: String\n\nDefault: ascending\n\n</td></tr><tr><td>\n\nstartIndex\n\n</td><td id=\"group_startIndex-SCIM-entry\">\n\nOne-based index into the table at which to start retrieving records. For example, if you set this parameter to 100, and the **count** parameter to 20, the endpoint returns records 100 through 119. **Note:** Any value that is set to less than one is interpreted as one.\n\nData type: String\n\nDefault: 1\n\n</td></tr></tbody>\n</table>|Name|Description|\n|----|-----------|\n|None| |\n\n### Headers\n\nThe following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table class=\"rest_api_request_headers\"><thead><tr><th>\n\nHeader\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nAccept\n\n</td><td id=\"Accept-SCIM-entry\">\n\nData format of the response body. Supported types: **application/json** or **application/scim+json**.Default: **application/json**\n\n</td></tr></tbody>\n</table>|Header|Description|\n|------|-----------|\n|None| |\n\n### Status codes\n\nThe following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table><thead><tr><th>\n\nStatus code\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\n200\n\n</td><td id=\"entry-200-status-code\">\n\nSuccessful. The request was successfully processed.\n\n</td></tr><tr><td>\n\n400\n\n</td><td id=\"status_400-SCIM-entry\">\n\nBad Request. A bad request type or malformed request was detected.-   Ensure that both the **attributes** and **excludedAttributes** query parameters have not been passed in the request.\n-   Ensure that the **count** parameter is not greater than 500.\n-   Ensure that all **filter** parameters are valid.\n\n</td></tr><tr><td>\n\n401\n\n</td><td id=\"entry-401-status-code\">\n\nUnauthorized. The user credentials are incorrect or have not been passed.\n\n</td></tr></tbody>\n</table>### Response body parameters \\(JSON\\)\n\n<table id=\"id_sqc_3br_3rb\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nitemsPerPage\n\n</td><td id=\"itemsPerPage-SCIM-entry\">\n\nNumber of records returned in the return results.Data type: Number\n\n</td></tr><tr><td>\n\nResources\n\n</td><td>\n\nList of returned department records.Data type: Object\n\n ```\n\"Resources\": {\n  \"id\": \"String\",\n  \"meta\": {Object},\n  \"name\": \"String\",\n  \"schemas\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nResources.id\n\n</td><td>\n\nSys\\_id of the department record.Data type: String\n\n</td></tr><tr><td>\n\nResources.meta\n\n</td><td>\n\nInformation pertaining to the department record.Data type: Object\n\n```\n\"meta\": {\n  \"created\": \"String\",\n  \"lastModified\": \"String\",\n  \"location\": \"String\",\n  \"resourcType\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nResources.meta.created\n\n</td><td>\n\nDate and time the associated department record was created.Data type: String\n\n</td></tr><tr><td>\n\nResources.meta.lastModified\n\n</td><td>\n\nDate and time the associated department record was last modified.Data type: String\n\n</td></tr><tr><td>\n\nResources.meta.location\n\n</td><td>\n\nURI of the associated department record.Data type: String\n\n</td></tr><tr><td>\n\nResources.meta.resourceType\n\n</td><td>\n\nSCIM resource type; always Department.Data type: String\n\n</td></tr><tr><td>\n\nResources.name\n\n</td><td>\n\nDepartment name.Data type: String\n\n</td></tr><tr><td>\n\nResources.schemas\n\n</td><td>\n\n \n\n</td></tr><tr><td>\n\nschemas\n\n</td><td>\n\n \n\n</td></tr><tr><td>\n\nstartIndex\n\n</td><td>\n\nOne-based index into the Department \\[cmn\\_department\\] table at which the records were returned.Data type: String\n\n</td></tr><tr><td>\n\ntotalResults\n\n</td><td id=\"totalResults-SCIM-entry\">\n\nTotal number of records that match the request.Data type: Number\n\n</td></tr></tbody>\n</table>### cURL request\n\nThis example shows how to retrieve the first two department records.\n\n```\ncurl \"https://instance-servicenow.com/api/now/scim/Departments?count=2\" \\\n--request GET \\\n--header \"Accept:application/scim+json\" \\\n```\n\nResponse:\n\n```\n{\n  \"schemas\":[\n    \"urn:ietf:params:scim:api:messages:2.0:ListResponse\"\n  ],\n  \"totalResults\":7,\n  \"Resources\":[\n    {\n      \"schemas\":[\n        \"urn:ietf:params:scim:schemas:custom:servicenow:2.0:Department\"\n      ],\n      \"id\":\"221db0edc611228401760aec06c9d929\",\n      \"meta\":{\n        \"resourceType\":\"Department\",\n        \"created\":\"2006-01-31T20:18:24Z\",\n        \"lastModified\":\"2012-02-18T07:01:40Z\",\n        \"location\":\"https://instance-servicenow.com/api/now/scim/Departments/221db0edc611228401760aec06c9d929\"\n      },\n      \"name\":\"Sales\"\n    },\n    {\n      \"schemas\":[\n        \"urn:ietf:params:scim:schemas:custom:servicenow:2.0:Department\"\n      ],\n      \"id\":\"221f3db5c6112284009f4becd3039cc9\",\n      \"meta\":{\n        \"resourceType\":\"Department\",\n        \"created\":\"2008-03-20T20:20:06Z\",\n        \"lastModified\":\"2012-02-18T07:01:22Z\",\n        \"location\":\"https://instance-servicenow.com/api/now/scim/Departments/221f3db5c6112284009f4becd3039cc9\"\n      },\n      \"name\":\"Development\"\n    }\n  ],\n  \"startIndex\":1,\n  \"itemsPerPage\":2\n}\n```\n\n## SCIM - GET /scim/Departments/\\{deparment\\_id\\}\n\nReturns the specified department record from the Department \\[cmn\\_department\\] table within a ServiceNow instance using the System for Cross-domain Identity Management \\(SCIM\\) protocol.\n\n### URL format\n\nVersioned URL: `/api/now/{api_version}/scim/Departments/{department_id}`\n\nDefault URL: `/api/now/scim/Departments/{department_id}`\n\n**Note:** Available versions are specified in the [REST API Explorer](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/use-REST-API-Explorer.md). For scripted REST APIs there is additional version information on the [Scripted REST Service form](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_CustomWebServices.md).\n\n### Supported request parameters\n\n<table class=\"rest_api_path_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\napi\\_version\n\n</td><td id=\"version-entry-RESTAPI\">\n\nOptional. Version of the endpoint to access. For example, `v1` or `v2`. Only specify this value to use an endpoint version other than the latest. Data type: String\n\n</td></tr><tr><td>\n\ndepartment\\_id\n\n</td><td>\n\nSys\\_id of the department record to return.Data type: String\n\n</td></tr></tbody>\n</table><table class=\"rest_api_query_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nattributes\n\n</td><td id=\"attributes-SCIM-entry\">\n\nComma-separated list of fields to return in the response. No other fields are returned.Can't be used with the **excludedAttributes** parameter.\n\nData type: String\n\nDefault: Return all fields unless **excludedAttributes** is specified.\n\n</td></tr><tr><td>\n\nexcludedAttributes\n\n</td><td id=\"excludedAttributes-SCIM-entry\">\n\nComma-separated list of fields to exclude from the records returned in the response. All other fields are returned.Can't be used with the **attributes** parameter.\n\nData type: String\n\nDefault: Do not exclude any fields.\n\n</td></tr></tbody>\n</table>|Name|Description|\n|----|-----------|\n|None| |\n\n### Headers\n\nThe following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table class=\"rest_api_request_headers\"><thead><tr><th>\n\nHeader\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nAccept\n\n</td><td id=\"Accept-SCIM-entry\">\n\nData format of the response body. Supported types: **application/json** or **application/scim+json**.Default: **application/json**\n\n</td></tr></tbody>\n</table>|Header|Description|\n|------|-----------|\n|None| |\n\n### Status codes\n\nThe following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table><thead><tr><th>\n\nStatus code\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\n200\n\n</td><td id=\"entry-200-status-code\">\n\nSuccessful. The request was successfully processed.\n\n</td></tr><tr><td>\n\n400\n\n</td><td id=\"status_400-SCIM-entry\">\n\nBad Request. A bad request type or malformed request was detected.-   Ensure that both the **attributes** and **excludedAttributes** query parameters have not been passed in the request.\n-   Ensure that the **count** parameter is not greater than 500.\n-   Ensure that all **filter** parameters are valid.\n\n</td></tr><tr><td>\n\n401\n\n</td><td id=\"entry-401-status-code\">\n\nUnauthorized. The user credentials are incorrect or have not been passed.\n\n</td></tr><tr><td>\n\n404\n\n</td><td id=\"entry-404-status-code\">\n\nNot found. The requested item wasn't found.\n\n</td></tr></tbody>\n</table>### Response body parameters \\(JSON\\)\n\n<table id=\"id_g3b_jdr_3rb\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nid\n\n</td><td id=\"id-dept-SCIM-entry\">\n\nSys\\_id of the department record.Data type: String\n\n</td></tr><tr><td>\n\nmeta\n\n</td><td id=\"meta-dept-SCIM-entry\">\n\nInformation pertaining to the department record.Data type: Object\n\n```\n\"meta\": {\n  \"created\": \"String\",\n  \"lastModified\": \"String\",\n  \"location\": \"String\",\n  \"resourcType\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nmeta.created\n\n</td><td id=\"meta_created-dept-SCIM-entry\">\n\nDate and time the associated department record was created.Data type: String\n\n</td></tr><tr><td>\n\nmeta.lastModified\n\n</td><td id=\"meta_lastModified-dept-SCIM-entry\">\n\nDate and time the associated department record was last modified.Data type: String\n\n</td></tr><tr><td>\n\nmeta.location\n\n</td><td id=\"meta_location-dept-SCIM-entry\">\n\nURI of the associated department record.Data type: String\n\n</td></tr><tr><td>\n\nmeta.resourceType\n\n</td><td id=\"meta_resourceType-dept-SCIM-entry\">\n\nSCIM resource type; always Department.Data type: String\n\n</td></tr><tr><td>\n\nname\n\n</td><td id=\"name-dept-SCIM-entry\">\n\nDepartment name.Data type: String\n\n</td></tr><tr><td>\n\nschemas\n\n</td><td id=\"schemas-dept-SCIM-entry\">\n\nSchema used when processing the request.Data type: String\n\n</td></tr></tbody>\n</table>### cURL request\n\nThis example shows how to retrieve a specific department record.\n\n```\ncurl \"https://instance-servicenow.com/api/now/scim/Departments/221db0edc611228401760aec06c9d929\" \\\n--request GET \\\n--header \"Accept:application/scim+json\" \\\n```\n\nResponse:\n\n```\n{\n  \"schemas\":[\n    \"urn:ietf:params:scim:schemas:custom:servicenow:2.0:Department\"\n  ],\n  \"id\":\"221db0edc611228401760aec06c9d929\",\n  \"meta\":{\n    \"resourceType\":\"Department\",\n    \"created\":\"2006-01-31T20:18:24Z\",\n    \"lastModified\":\"2012-02-18T07:01:40Z\",\n    \"location\":\"https://instance-servicenow.com/api/now/scim/Departments/221db0edc611228401760aec06c9d929\"\n  },\n  \"name\":\"Sales\"\n}\n```\n\n## SCIM - GET /scim/Locations\n\nReturns one or more location records from the Location \\[cmn\\_location\\] table within a ServiceNow instance using the System for Cross-domain Identity Management \\(SCIM\\) protocol.\n\n**Note:** A query that does not return any matches returns success \\(HTTP status code 200\\) with **totalResults** set to 0.\n\n### URL format\n\nVersioned URL: `/api/now/{api_version}/scim/Locations`\n\nDefault URL: `/api/now/scim/Locations`\n\n**Note:** Available versions are specified in the [REST API Explorer](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/use-REST-API-Explorer.md). For scripted REST APIs there is additional version information on the [Scripted REST Service form](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_CustomWebServices.md).\n\n### Supported request parameters\n\n<table class=\"rest_api_path_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\napi\\_version\n\n</td><td id=\"version-entry-RESTAPI\">\n\nOptional. Version of the endpoint to access. For example, `v1` or `v2`. Only specify this value to use an endpoint version other than the latest. Data type: String\n\n</td></tr></tbody>\n</table><table class=\"rest_api_query_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nattributes\n\n</td><td id=\"attributes-SCIM-entry\">\n\nComma-separated list of fields to return in the response. No other fields are returned.Can't be used with the **excludedAttributes** parameter.\n\nData type: String\n\nDefault: Return all fields unless **excludedAttributes** is specified.\n\n</td></tr><tr><td>\n\ncount\n\n</td><td id=\"count-SCIM-entry\">\n\nNumber of records to return. A negative value is interpreted as zero.Data type: Number\n\nMaximum: 500 - A value greater than this results in a bad request error.\n\nDefault: 10\n\n</td></tr><tr><td>\n\nexcludedAttributes\n\n</td><td id=\"excludedAttributes-SCIM-entry\">\n\nComma-separated list of fields to exclude from the records returned in the response. All other fields are returned.Can't be used with the **attributes** parameter.\n\nData type: String\n\nDefault: Do not exclude any fields.\n\n</td></tr><tr><td>\n\nfilter\n\n</td><td>\n\nFilter expression to apply to the return results. Field filters are expressed as `<field_name> <operator> <\"value\">`. Refer to [RFC7644](https://datatracker.ietf.org/doc/html/rfc7644#section-3.4.2) for a list of the valid operators. **Note:** The `NOT` operator is not supported by this method.\n\n For example, to filter for all locations whose name starts with \"Ch\", enter `displayName SW \"Ch\"`.\n\n To specify more than one field filter, concatenate the filters using the `AND` operand. For example, to filter for all locations whose name starts with \"Ch\" and were last modified before October 3, 2021, enter `displayName SW \"Ch\" AND meta.lastModified lt \"2021-10-03T00:00:00Z\"`. Use dot-walking to specify nested attributes.\n\n Data type: String\n\n Default: No filtering\n\n</td></tr><tr><td>\n\nsortBy\n\n</td><td id=\"group_sortBy-SCIM-entry\">\n\nMust be specified with the **sortOrder** parameter. Field by which to sort the return results. Sorting is case-insensitive. You can only use those parameters available for filtering for the **sortBy** parameter, except that **externalId** is not allowed.\n\nFor values that are null:\n\n-   sorted by ascending: Null values are sorted to the top.\n-   sorted by descending: Null values are sorted to the bottom.\n\nData type: String\n\nDefault: No sort\n\n</td></tr><tr><td>\n\nsortOrder\n\n</td><td id=\"sortOrder-SCIM-entry\">\n\nMust be specified with the **sortBy** parameter. Order in which the **sortBy** parameter is applied to the return results. Valid values:\n\n-   ascending\n-   descending\n\nData type: String\n\nDefault: ascending\n\n</td></tr><tr><td>\n\nstartIndex\n\n</td><td id=\"group_startIndex-SCIM-entry\">\n\nOne-based index into the table at which to start retrieving records. For example, if you set this parameter to 100, and the **count** parameter to 20, the endpoint returns records 100 through 119. **Note:** Any value that is set to less than one is interpreted as one.\n\nData type: String\n\nDefault: 1\n\n</td></tr></tbody>\n</table>|Name|Description|\n|----|-----------|\n|None| |\n\n### Headers\n\nThe following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table class=\"rest_api_request_headers\"><thead><tr><th>\n\nHeader\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nAccept\n\n</td><td id=\"Accept-SCIM-entry\">\n\nData format of the response body. Supported types: **application/json** or **application/scim+json**.Default: **application/json**\n\n</td></tr></tbody>\n</table>|Header|Description|\n|------|-----------|\n|None| |\n\n### Status codes\n\nThe following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table><thead><tr><th>\n\nStatus code\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\n200\n\n</td><td id=\"entry-200-status-code\">\n\nSuccessful. The request was successfully processed.\n\n</td></tr><tr><td>\n\n400\n\n</td><td id=\"status_400-SCIM-entry\">\n\nBad Request. A bad request type or malformed request was detected.-   Ensure that both the **attributes** and **excludedAttributes** query parameters have not been passed in the request.\n-   Ensure that the **count** parameter is not greater than 500.\n-   Ensure that all **filter** parameters are valid.\n\n</td></tr><tr><td>\n\n401\n\n</td><td id=\"entry-401-status-code\">\n\nUnauthorized. The user credentials are incorrect or have not been passed.\n\n</td></tr></tbody>\n</table>### Response body parameters \\(JSON\\)\n\n<table id=\"id_qt1_xfr_3rb\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nitemsPerPage\n\n</td><td id=\"itemsPerPage-SCIM-entry\">\n\nNumber of records returned in the return results.Data type: Number\n\n</td></tr><tr><td>\n\nResources\n\n</td><td>\n\nList of returned location records.Data type: Object\n\n ```\n\"Resources\": {\n  \"id\": \"String\",\n  \"meta\": {Object},\n  \"name\": \"String\",\n  \"schemas\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nResources.id\n\n</td><td>\n\nSys\\_id of the location record.Data type: String\n\n</td></tr><tr><td>\n\nResources.meta\n\n</td><td>\n\nInformation pertaining to the location record.Data type: Object\n\n```\n\"meta\": {\n  \"created\": \"String\",\n  \"lastModified\": \"String\",\n  \"location\": \"String\",\n  \"resourceType\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nResources.meta.created\n\n</td><td>\n\nDate and time the associated location record was created.Data type: String\n\n</td></tr><tr><td>\n\nResources.meta.lastModified\n\n</td><td>\n\nDate and time the associated location record was last modified.Data type: String\n\n</td></tr><tr><td>\n\nResources.meta.location\n\n</td><td>\n\nURI of the associated location record.Data type: String\n\n</td></tr><tr><td>\n\nResources.meta.resourceType\n\n</td><td>\n\nSCIM resource type; always Location.Data type: String\n\n</td></tr><tr><td>\n\nResources.name\n\n</td><td>\n\nLocation name.Data type: String\n\n</td></tr><tr><td>\n\nResources.schemas\n\n</td><td>\n\nSchema used when processing the request.Data type: String\n\n</td></tr><tr><td>\n\nschemas\n\n</td><td>\n\nSchema used to process the list response to the request. For example: `\"urn:ietf:params:scim:api:messages:2.0:ListResponse\"` Data type: String\n\n</td></tr><tr><td>\n\nstartIndex\n\n</td><td>\n\nOne-based index into the Location \\[cmn\\_location\\] table at which the records were returned.Data type: String\n\n</td></tr><tr><td>\n\ntotalResults\n\n</td><td id=\"totalResults-SCIM-entry\">\n\nTotal number of records that match the request.Data type: Number\n\n</td></tr></tbody>\n</table>### cURL request\n\nThis example shows how to retrieve a the first two company records.\n\n```\ncurl \"https://instance-servicenow.com/api/now/scim/Locations?count=2\" \\\n--request GET \\\n--header \"Accept:application/scim+json\" \\\n```\n\nResponse\n\n```\n{\n  \"schemas\":[\n    \"urn:ietf:params:scim:api:messages:2.0:ListResponse\"\n  ],\n  \"totalResults\":426,\n  \"Resources\":[\n    {\n      \"schemas\":[\"urn:ietf:params:scim:schemas:custom:servicenow:2.0:Location\"],\n      \"id\":\"0002c0a93790200044e0bfc8bcbe5df5\",\n      \"meta\":{\n        \"resourceType\":\"Location\",\n        \"created\":\"2012-02-19T18:39:00Z\",\n        \"lastModified\":\"2012-02-19T18:39:00Z\",\n        \"location\":\"https://instance-servicenow.com/api/now/scim/Locations/0002c0a93790200044e0bfc8bcbe5df5\"\n      },\n      \"name\":\"2-10-1 Yurakucho, Chiyoda-ku, Tokyo\"\n    },\n    {\n      \"schemas\":[\"urn:ietf:params:scim:schemas:custom:servicenow:2.0:Location\"],\n      \"id\":\"0594ed7437d0200044e0bfc8bcbe5df0\",\n      \"meta\":{\n        \"resourceType\":\"Location\",\n        \"created\":\"2012-02-17T17:54:15Z\",\n        \"lastModified\":\"2021-08-31T14:13:11Z\",\n        \"location\":\"https://instance-servicenow.com/api/now/scim/Locations/0594ed7437d0200044e0bfc8bcbe5df0\"\n      },\n      \"name\":\"Colombia\"\n    }\n  ],\n  \"startIndex\":1,\n  \"itemsPerPage\":2\n}\n```\n\n## SCIM - GET /scim/Locations/\\{location\\_id\\}\n\nReturns the specified location record from the Location \\[cmn\\_location\\] table within a ServiceNow instance using the System for Cross-domain Identity Management \\(SCIM\\) protocol.\n\n### URL format\n\nVersioned URL: `/api/now/{api_version}/scim/Locations/{location_id}`\n\nDefault URL: `/api/now/scim/Locations/{location_id}`\n\n**Note:** Available versions are specified in the [REST API Explorer](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/use-REST-API-Explorer.md). For scripted REST APIs there is additional version information on the [Scripted REST Service form](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_CustomWebServices.md).\n\n### Supported request parameters\n\n<table class=\"rest_api_path_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\napi\\_version\n\n</td><td id=\"version-entry-RESTAPI\">\n\nOptional. Version of the endpoint to access. For example, `v1` or `v2`. Only specify this value to use an endpoint version other than the latest. Data type: String\n\n</td></tr><tr><td>\n\nlocation\\_id\n\n</td><td>\n\nSys\\_id of the location record to return.Data type: String\n\n</td></tr></tbody>\n</table><table class=\"rest_api_query_parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nattributes\n\n</td><td id=\"attributes-SCIM-entry\">\n\nComma-separated list of fields to return in the response. No other fields are returned.Can't be used with the **excludedAttributes** parameter.\n\nData type: String\n\nDefault: Return all fields unless **excludedAttributes** is specified.\n\n</td></tr><tr><td>\n\nexcludedAttributes\n\n</td><td id=\"excludedAttributes-SCIM-entry\">\n\nComma-separated list of fields to exclude from the records returned in the response. All other fields are returned.Can't be used with the **attributes** parameter.\n\nData type: String\n\nDefault: Do not exclude any fields.\n\n</td></tr></tbody>\n</table>|Name|Description|\n|----|-----------|\n|None| |\n\n### Headers\n\nThe following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table class=\"rest_api_request_headers\"><thead><tr><th>\n\nHeader\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nAccept\n\n</td><td id=\"Accept-SCIM-entry\">\n\nData format of the response body. Supported types: **application/json** or **application/scim+json**.Default: **application/json**\n\n</td></tr></tbody>\n</table>|Header|Description|\n|------|-----------|\n|None| |\n\n### Status codes\n\nThe following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).\n\n<table><thead><tr><th>\n\nStatus code\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\n200\n\n</td><td id=\"entry-200-status-code\">\n\nSuccessful. The request was successfully processed.\n\n</td></tr><tr><td>\n\n400\n\n</td><td id=\"status_400-SCIM-entry\">\n\nBad Request. A bad request type or malformed request was detected.-   Ensure that both the **attributes** and **excludedAttributes** query parameters have not been passed in the request.\n-   Ensure that the **count** parameter is not greater than 500.\n-   Ensure that all **filter** parameters are valid.\n\n</td></tr><tr><td>\n\n401\n\n</td><td id=\"entry-401-status-code\">\n\nUnauthorized. The user credentials are incorrect or have not been passed.\n\n</td></tr><tr><td>\n\n404\n\n</td><td id=\"entry-404-status-code\">\n\nNot found. The requested item wasn't found.\n\n</td></tr></tbody>\n</table>### Response body parameters \\(JSON\\)\n\n<table id=\"id_s2d_33r_3rb\"><thead><tr><th>\n\nName\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nid\n\n</td><td id=\"id-location-SCIM-entry\">\n\nSys\\_id of the location record.Data type: String\n\n</td></tr><tr><td>\n\nmeta\n\n</td><td id=\"meta-location-SCIM-entry\">\n\nInformation pertaining to the location record.Data type: Object\n\n```\n\"meta\": {\n  \"created\": \"String\",\n  \"lastModified\": \"String\",\n  \"location\": \"String\",\n  \"resourceType\": \"String\"\n}\n```\n\n</td></tr><tr><td>\n\nmeta.created\n\n</td><td id=\"meta_created-location-SCIM-entry\">\n\nDate and time the associated location record was created.Data type: String\n\n</td></tr><tr><td>\n\nmeta.lastModified\n\n</td><td id=\"meta_lastModified-location-SCIM-entry\">\n\nDate and time the associated location record was last modified.Data type: String\n\n</td></tr><tr><td>\n\nmeta.location\n\n</td><td id=\"meta_location-location-SCIM-entry\">\n\nURI of the associated location record.Data type: String\n\n</td></tr><tr><td>\n\nmeta.resourceType\n\n</td><td id=\"meta_resourceType-location-SCIM-entry\">\n\nSCIM resource type; always Location.Data type: String\n\n</td></tr><tr><td>\n\nname\n\n</td><td id=\"name-location-SCIM-entry\">\n\nLocation name.Data type: String\n\n</td></tr><tr><td>\n\nschemas\n\n</td><td id=\"schemas-location-SCIM-entry\">\n\nSchema used when processing the request.Data type: String\n\n</td></tr></tbody>\n</table>### cURL request\n\nThis example shows how to retrieve a specific location record.\n\n```\ncurl \"https://instance-servicenow.com/api/now/scim/Locations/0c43af40c6112275011a4bd4c0143fbf\" \\\n--request GET \\\n--header \"Accept:application/scim+json\" \\\n```\n\nResponse:\n\n```\n{\n  \"schemas\":[\"urn:ietf:params:scim:schemas:custom:servicenow:2.0:Location\"],\n  \"id\":\"0594ed7437d0200044e0bfc8bcbe5df0\",\n  \"meta\":{\n    \"resourceType\":\"Location\",\n    \"created\":\"2012-02-17T17:54:15Z\",\n    \"lastModified\":\"2021-08-31T14:13:11Z\",\n    \"location\":\"https://instance-servicenow.com/api/now/scim/Locations/0594ed7437d0200044e0bfc8bcbe5df0\"\n  },\n  \"name\":\"Colombia\"\n}\n```\n\n"}}