---
"@context": https://schema.org
"@type": TechArticle
"@id": https://www.twilio.com/docs/api/errors/25004#article
headline: "25004: The provided user's external ID is invalid"
url: https://www.twilio.com/docs/api/errors/25004
inLanguage: en
dateModified: 2026-06-08T11:29:20.000Z
author:
  "@type": Organization
  name: Twilio Developer Education Team
publisher:
  "@type": Organization
  name: Twilio
---

# 25004: The provided user's external ID is invalid

Log Type: APPLICATION

Log Level: ERROR

## Description

This error occurs when you send a SCIM request to manage an organization user and the `externalId` value does not meet the allowed length requirements. Twilio accepts `externalId` as part of the SCIM user payload for managed user operations.

### Possible causes

* The `externalId` value is shorter than 2 characters.
* The `externalId` value is longer than 255 characters.
* Your SCIM client or identity provider sent an `externalId` value in the user payload that falls outside the supported length range.

### Possible solutions

* Set `externalId` to a value that is between 2 and 255 characters long, then retry the request.
* Review the SCIM request body you send to `POST /scim/v2/Users` and confirm that the `externalId` field contains a valid value before you submit it.
* If you provision users through an identity provider, review the attribute it sends for `externalId` and update the mapping so synced values stay within the supported length range.

#### Additional resources

* [SCIM API overview](/docs/iam/scim)
* [SCIM API reference](/docs/iam/scim/api-reference)
* [Okta SCIM integration](/docs/iam/scim/okta-integration)