Skip to main content

User

SCIM User resource as defined in RFC 7643 Section 4.1. Represents a user account in the system.

activeboolean

Indicates the user's administrative status. Typically true means able to log in, false means account suspended

addresses object[]

Physical mailing addresses for the user

  • Array [
  • countrystring

    The country name in ISO 3166-1 alpha-2 format

    formattedstring

    The full mailing address, formatted for display

    localitystring

    The city or locality component

    postalCodestring

    The zip code or postal code component

    primaryboolean

    Indicates if this is the primary address

    regionstring

    The state or region component

    streetAddressstring

    The full street address component

    typestring

    The type of address (work, home, other)

  • ]
  • displayNamestring

    The name of the user, suitable for display to end-users

    emails object[]

    Email addresses for the user

  • Array [
  • displaystring

    A human-readable name for the email address

    primaryboolean

    Indicates if this is the primary email address

    typestring

    The type of email address (work, home, other)

    valuestring<email>

    The email address value

  • ]
  • externalIdstring

    Identifier for the user as defined by the provisioning client. Allows the client to maintain their own identifier.

    groups object[]

    Groups to which the user belongs

  • Array [
  • $refstring<uri>

    The URI of the corresponding Group resource

    displaystring

    A human-readable name for the group

    typestring

    The type of group membership

    valuestring

    The identifier of the group

  • ]
  • idstring

    Unique identifier for the user. Assigned by the service provider. MUST be unique across the entire set of resources. Immutable.

    localestring

    The user's default location for purposes of localizing items such as currency and date/time format. Valid value is a language tag as defined in RFC 5646

    meta object

    Resource metadata as defined in RFC 7643 Section 3.1

    createdstring<date-time>

    The timestamp when the resource was created

    lastModifiedstring<date-time>

    The timestamp when the resource was last modified

    locationstring<uri>

    The URI of the resource

    resourceTypestring

    The name of the resource type (e.g., User, Group)

    versionstring

    The version of the resource. Used for ETag-based versioning. Weak ETags are prefixed with W/

    name object

    The components of the user's name

    familyNamestring

    The family name (last name) of the user

    formattedstring

    The full name, including all middle names, titles, and suffixes

    givenNamestring

    The given name (first name) of the user

    honorificPrefixstring

    The honorific prefix(es) of the user (e.g., Ms., Dr.)

    honorificSuffixstring

    The honorific suffix(es) of the user (e.g., III, Jr.)

    middleNamestring

    The middle name(s) of the user

    nickNamestring

    The casual way to address the user

    phoneNumbers object[]

    Phone numbers for the user

  • Array [
  • displaystring

    A human-readable name for the phone number

    primaryboolean

    Indicates if this is the primary phone number

    typestring

    The type of phone number (work, home, mobile, fax, pager, other)

    valuestring

    The phone number in E.164 format (e.g., tel:+1-201-555-0123)

  • ]
  • preferredLanguagestring

    The user's preferred written or spoken languages. Format as defined in RFC 7231 Section 5.3.5

    profileUrlstring<uri>

    A URI pointing to the user's online profile

    schemasstring[]required

    The schema URIs that define this resource

    Possible values: [urn:ietf:params:scim:schemas:core:2.0:User]

    timezonestring

    The user's time zone in IANA Time Zone database format

    titlestring

    The user's title, such as Vice President

    userNamestringrequired

    Unique identifier for the user, typically used for authentication. Often the user's email address. REQUIRED. Case insensitive.

    userTypestring

    Identifies the relationship between the organization and the user. Typical values: Contractor, Employee, Intern, Temp, External

    User
    {
    "active": true,
    "addresses": [
    {
    "country": "string",
    "formatted": "string",
    "locality": "string",
    "postalCode": "string",
    "primary": true,
    "region": "string",
    "streetAddress": "string",
    "type": "string"
    }
    ],
    "displayName": "string",
    "emails": [
    {
    "display": "string",
    "primary": true,
    "type": "string",
    "value": "user@example.com"
    }
    ],
    "externalId": "string",
    "groups": [
    {
    "$ref": "string",
    "display": "string",
    "type": "string",
    "value": "string"
    }
    ],
    "id": "string",
    "locale": "string",
    "meta": {
    "created": "2024-07-29T15:51:28.071Z",
    "lastModified": "2024-07-29T15:51:28.071Z",
    "location": "string",
    "resourceType": "string",
    "version": "string"
    },
    "name": {
    "familyName": "string",
    "formatted": "string",
    "givenName": "string",
    "honorificPrefix": "string",
    "honorificSuffix": "string",
    "middleName": "string"
    },
    "nickName": "string",
    "phoneNumbers": [
    {
    "display": "string",
    "primary": true,
    "type": "string",
    "value": "string"
    }
    ],
    "preferredLanguage": "string",
    "profileUrl": "string",
    "schemas": [
    "urn:ietf:params:scim:schemas:core:2.0:User"
    ],
    "timezone": "string",
    "title": "string",
    "userName": "string",
    "userType": "string"
    }