> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://contentful.com/developers/docs/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://contentful.com/developers/docs/_mcp/server. ## Group Users The **user** entity provides identifying information about members of your organization, teams, and spaces. **Note:** The user object is owned by the individual whose account is associated with it. Only this individual can make changes to the user object, including deleting it. Organizations *indirectly* maintain control over users within the organization via the several membership objects described in this documentation. ### Get all users in organization [Get all users](/references/user-management-api/users/get-all-users-for-an-organization) This endpoint returns a paginated collection of users who are members of this organization. Organization owners and admins of the requested organization receive full user details. Members of the requested organization who are not owners or admins receive only a limited set of user information. This endpoint is accessible by all members of the organization. #### Query Parameters | Name | Details | Description | | --------------- | ----------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `skip`, `limit` | - | Specify requested page of result set. See [Pagination](#/introduction/pagination) for more details. | | `query` | Fields searched: `sys.id`, `firstName`, `lastName`, `email` | Specify a string to search for matching resources against. See [Searching Multiple Attributes](#/introduction/searching-multiple-attributes) for more details. | #### Response for admin ```js { "total": 2, "limit": 25, "skip": 0, "sys": { "type": "Array" }, "items": [ { "firstName": "Sascha", "lastName": "Konietzke", "avatarUrl": "http://a0.twimg.com/profile_images/148466442/sascha_konietzke_normal.jpg", "email": "user@example.com", "activated": true, "signInCount": 1277, "confirmed": true, "2faEnabled": true, "sys": { "type": "User", "id": "7uqvFPPLzgtVaezGvjA9U6", "version": 1733, "createdAt": "2013-04-11T20:04:37Z", "updatedAt": "2017-09-20T08:51:45Z" } }, { "firstName": "Steeephen", "lastName": "Sugden", "avatarUrl": "https://www.gravatar.com/avatar/792867cb6657d4b936e474374985e58f?s=50&d=https%3A%2F%2Fstatic.quirely.com%2Fgatekeeper%2Fusers%2Fdefault-f33548606250cac861471edee5f997d0f50c8ad0ff68a700c394330bf0938a96.png", "email": "stephen@contentful.com", "activated": true, "signInCount": 4, "confirmed": true, "2faEnabled": true, "sys": { "type": "User", "id": "3XdAASLq5SdkZ9B97bHhKW", "version": 12, "createdAt": "2014-06-26T15:21:46Z", "updatedAt": "2015-12-01T14:40:35Z" } } ] } ``` #### Response for non-admin ```js { "total": 1, "limit": 25, "skip": 0, "sys": { "type": "Array" }, "items": [ { "firstName": "Sascha", "lastName": "Konietzke", "avatarUrl": "http://a0.twimg.com/profile_images/148466442/sascha_konietzke_normal.jpg", "sys": { "type": "User", "id": "7uqvFPPLzgtVaezGvjA9U6", "version": 1, "createdAt": "2025-12-28T04:00:29Z", "updatedAt": "2026-02-14T01:26:38Z" } } ] } ``` ### Get all users in a space [Get all users](/references/user-management-api/users/get-all-users-for-a-space) This endpoint returns a paginated list of all users in a space. Note that this includes both users who have access directly, via a space membership, as well as indirectly, via membership in a team that has access to the space via a team space membership. This endpoint is accessible by all members of the space. #### Query Parameters | Name | Details | Description | | --------------- | ------- | --------------------------------------------------------------------------------------------------- | | `skip`, `limit` | - | Specify requested page of result set. See [Pagination](#/introduction/pagination) for more details. | The following response for this endpoint depends on the requester’s role in the space. * **Admin requesters** receive full user information. * **Non-admin requesters** receive a reduced (minified) representation of each user. The top-level pagination structure of the response remains the same, but the fields returned for each user in items may differ. #### Response for admin ```js { "total": 2, "limit": 25, "skip": 0, "sys": { "type": "Array" }, "items": [ { "firstName": "Sascha", "lastName": "Konietzke", "avatarUrl": "http://a0.twimg.com/profile_images/148466442/sascha_konietzke_normal.jpg", "email": "user@example.com", "activated": true, "signInCount": 1277, "confirmed": true, "2faEnabled": true, "sys": { "type": "User", "id": "7uqvFPPLzgtVaezGvjA9U6", "version": 1733, "createdAt": "2013-04-11T20:04:37Z", "updatedAt": "2017-09-20T08:51:45Z" } }, { "firstName": "Steeephen", "lastName": "Sugden", "avatarUrl": "https://www.gravatar.com/avatar/792867cb6657d4b936e474374985e58f?s=50&d=https%3A%2F%2Fstatic.quirely.com%2Fgatekeeper%2Fusers%2Fdefault-f33548606250cac861471edee5f997d0f50c8ad0ff68a700c394330bf0938a96.png", "email": "stephen@contentful.com", "activated": true, "signInCount": 4, "confirmed": true, "2faEnabled": true, "sys": { "type": "User", "id": "3XdAASLq5SdkZ9B97bHhKW", "version": 12, "createdAt": "2014-06-26T15:21:46Z", "updatedAt": "2015-12-01T14:40:35Z" } } ] } ``` > **Info** > > **Note**: Non-admin clients should not assume that all user attributes are present in the response. Fields such as `email`, `activated`, `signInCount`, `confirmed`, `2faEnabled`, `version`, `createdAt`, and `updatedAt` may be omitted for non-admin requesters. #### Response for non-admin ```js { "total": 2, "limit": 25, "skip": 0, "sys": { "type": "Array" }, "items": [ { "firstName": "Sascha", "lastName": "Konietzke", "avatarUrl": "http://a0.twimg.com/profile_images/148466442/sascha_konietzke_normal.jpg", "sys": { "type": "User", "id": "7uqvFPPLzgtVaezGvjA9U6" } }, { "firstName": "Steeephen", "lastName": "Sugden", "avatarUrl": "https://www.gravatar.com/avatar/792867cb6657d4b936e474374985e58f?s=50&d=https%3A%2F%2Fstatic.quirely.com%2Fgatekeeper%2Fusers%2Fdefault-f33548606250cac861471edee5f997d0f50c8ad0ff68a700c394330bf0938a96.png", "sys": { "type": "User", "id": "3XdAASLq5SdkZ9B97bHhKW" } } ] } ``` ### Get a single user [Get a single user (organization-scoped)](/references/user-management-api/users/get-a-user-in-an-organization) [Get a single user (space-scoped)](/references/user-management-api/users/get-a-user-in-a-space) These endpoints return details about an existing user, either in the context of an organization or a space. The first endpoint (scoped to an organization) is accessible to all organization members; the second (scoped to a space) is accessible to all members of that space. #### Response ```js { "firstName": "Sascha", "lastName": "Konietzke", "avatarUrl": "http://a0.twimg.com/profile_images/148466442/sascha_konietzke_normal.jpg", "email": "user@example.com", "activated": true, "signInCount": 1277, "confirmed": true, "2faEnabled": true, "sys": { "type": "User", "id": "7uqvFPPLzgtVaezGvjA9U6", "version": 1733, "createdAt": "2013-04-11T20:04:37Z", "updatedAt": "2017-09-20T08:51:45Z" } } ```