---
"@context": https://schema.org
"@type": TechArticle
"@id": https://www.twilio.com/docs/api/errors/25015#article
headline: "25015: The SCIM PATCH request is invalid"
url: https://www.twilio.com/docs/api/errors/25015
inLanguage: en
dateModified: 2026-06-09T11:00:42.000Z
author:
  "@type": Organization
  name: Twilio Developer Education Team
publisher:
  "@type": Organization
  name: Twilio
---

# 25015: The SCIM PATCH request is invalid

Log Type: APPLICATION

Log Level: ERROR

## Description

You receive this error when your request to `PATCH /scim/v2/Users/{id}` does not use the SCIM `PATCH` structure required by the SCIM API. Your request body must include the `urn:ietf:params:scim:api:messages:2.0:PatchOp` schema and an `Operations` array.

### Possible causes

* The JSON body does not follow the documented SCIM `PATCH` format for `PATCH /scim/v2/Users/{id}`.
* The `schemas` array is missing `urn:ietf:params:scim:api:messages:2.0:PatchOp`.
* The `Operations` array is missing, empty, or incorrectly structured.
* The request attempts to patch attributes outside the supported set of fields for this endpoint, or uses unsupported field paths for the operation payload. `PATCH` support for `active`, `name.givenName`, `name.familyName`, `displayName`, `timezone`, `locale`, `emails`, and `userName`.

### Possible solutions

* Send the request to `PATCH /scim/v2/Users/{id}` with a SCIM `PATCH` body that includes `schemas` with `urn:ietf:params:scim:api:messages:2.0:PatchOp` and an `Operations` array containing each change.
* Compare your request body against the documented `PATCH` example and keep the JSON property names and nesting for each operation consistent with that format.
* Patch only supported fields for this endpoint: `active`, `name.givenName`, `name.familyName`, `displayName`, `timezone`, `locale`, `emails`, and `userName`.
* If you update `emails` and `userName` in the same request, make sure the primary email value matches the username.

#### Additional resources

* [SCIM API overview](/docs/iam/scim)
* [SCIM API reference](/docs/iam/scim/api-reference)
* [Set up OAuth for SCIM](/docs/iam/scim/oauth-setup)