Skip to main content

Supported Schemas

The SCIM API supports the following schemas.

["urn:ietf:params:scim:schemas:core:2.0:User"]

Parameter nameExampleDescription
roles
"roles": [
{
"type": "seatType",
"value": "Full"
}
]
Array. Enterprise plan only. Each item in the array is an object with two properties: "type": "seatType" and "value":, which must be one of Full, Dev, Collab, or View.
givenNameJohn
familyNameDoe
displayNameJohn DoeThis value is limited to 100 characters or less.
titleDesign Manager
userNamejohndoe@example.comString. The user's email. Changing this attribute will change the user account's email in Figma. This value is limited to 100 characters or less.
activetrueBoolean. Use this parameter to deactivate or reactivate users in Figma. Deactivated users are removed from the organization.
externalIdaaaabbbbbbcccccString. The IdP's external ID for the user. Figma stores but does not use this parameter. This value is limited to 255 characters or less.

["urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"]

Parameter nameExample
employeeNumber70198422
costCenter093923
organizationProduct
divisionMobile
departmentDesigners
managerValueexamplemanager@example.com
managerDisplayNameJohn Doe

["urn:ietf:params:scim:schemas:core:2.0:Group"]

Parameter nameExampleDescription
displayNameexample_group_nameString. Sets the name of the SCIM group. This value is limited to 255 characters or less.
members
"members": [
{
"value": "1427545874257949557",
"display": "scimuser@example.com"
},
{
"value": "1360815874257948001",
"display": "anotherscimuser@example.com"
},
]
Array. A list of members for the SCIM group.
externalId123456789String. An ID that uniquely identifies the group in the IdP. This value is limited to 255 characters or less.

Custom Parameters

The custom parameter provided by this schema is used to designate organization administrators.

info

Note: Previously, product seats were managed using custom parameters. Seats are now managed using the roles parameter, a part of the Core user schema.

["urn:ietf:params:scim:schemas:extension:figma:enterprise:2.0:User"]

Parameter nameExampleDescription
figmaAdmintrueBoolean. Enterprise plan only. If true sets the user as a Figma organization administrator.