> For the complete documentation index, see [llms.txt](https://docs.balkan.id/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.balkan.id/lifecycle-management/access-requests/new-scim-access-request.md). # New SCIM access request ### Enable SCIM for your application 1. In the **Integrations** section, click on the **Setup** icon for the application you want to set up SCIM.
2. In the **Fulfillment Options,** select "SCIM" and save the changes.
Once saved, the SCIM will be enabled for the particular application. You can now perform SCIM access requests. The New SCIM Access Request encompasses three core functionalities: * **Entity Creation** * **Entity Assignment** * **Entity Deletion** ### Entity Creation Entity Creation allows you to create new entities (such as identities - for example, users, service accounts, connections - for example, groups, and resources - for example, application) within your system via SCIM access requests. This is typically used when a new user needs to be added, or a new group/resource needs to be created, within the application that supports SCIM integration. **Select an application:** Select the application for which you want to create a new entity (only applications with SCIM enabled). **Put the SCIM Endpoint:** When setting up the creation request, specify the appropriate endpoint. For example, in the case of creating a user, the endpoint might be '/users' or '/groups' for creating a group. Base URL should not be included in the SCIM endpoint. For example: \ Base URL: \ Endpoint for creating a user: /users **Configure Payload:** A json form will be presented for configuring the payload. This lets you define the types of connections or resources (e.g., identities, groups, roles, policies for connections, resources and users) and their respective names.
**Preview and Create Request:** Preview your SCIM entity creation request and submit it by clicking on "Create Request". The request will be visible in the my task page of the reviewer. **Approval and Update:** Following approval (from the my task page of reviewer), the SCIM permissions within the application will be updated accordingly. ### Entity Assignment Entity Assignment allows you to assign entities (such as identities - for example, users, service accounts, connections - for example, groups, and resources - for example, application) within your system via SCIM access requests. **Select an application:** Select the application for which you want to create a new entity (only applications with SCIM enabled). **Put the SCIM Endpoint:** When setting up the assignment request, specify the appropriate endpoint. For example, in the case of creating a user, the endpoint might be '/group/assign' to assign user to a group. Base URL should not be included in the SCIM endpoint. **Configure Payload:** A json form will be presented for configuring the payload. This lets you define the types of connections or resources (e.g., identities, groups, roles, policies for connections, resources and users) and their respective names.
**Preview and Create Request:** Preview your SCIM assignment request and submit it by clicking on "Create Request". The request will be visible in the my task page of the reviewer. **Approval and Update:** Following approval(from the my task page of reviewer), the SCIM permissions within the application will be updated accordingly. ### Entity Deletion **Entity Deletion** allows you to remove or delete an entity (such as identities - for example, users, service accounts, connections - for example, groups, and resources - for example, application) within your system via SCIM access requests. **Select an application:** Select the application for which you want to create a new entity (only applications with SCIM enabled). **Put the SCIM Endpoint:** When setting up the deletion request, specify the appropriate endpoint. For example, in the case of deleting a user, the endpoint might be '/group/delete'. Base URL should not be included in the SCIM endpoint.
**Preview and Create Request:** Preview your SCIM deletion request and submit it by clicking on "Create Request". The request will be visible in the my task page of the reviewer. **Approval and Update:** Following approval(from the my task page of reviewer), the SCIM permissions within the application will be updated accordingly. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.balkan.id/lifecycle-management/access-requests/new-scim-access-request.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.