Is it easy or difficult to use our developer documentation? Let us know in this short survey ↗

On this page

Build a SCIM provisioning integration overview

This guide series teaches you the steps required to build an Okta integration that uses SCIM to handle user provisioning.

Learning outcomes

  • Prepare a SCIM API service.
  • Connect the SCIM API service to Okta through an integration.
  • Test your integration to make sure everything is functional.

What you need


It's important to know how to set up and test your cloud-based app and API endpoints to successfully deploy an Okta integration using SCIM provisioning.

If you need more detail on the concepts behind lifecycle management with SCIM and Okta, see Understanding SCIM.

While many ISVs have custom APIs for managing user accounts, this guide assumes that you use the System for Cross-domain Identity Management (opens new window) (SCIM) protocol, an industry standard that supports all of the needed features for lifecycle provisioning. For more technical details on how you can take advantage of the SCIM API with Okta, see our SCIM Protocol reference.

Your Okta integration should use Single Sign-On (SSO) to initiate end user authentication. Learn how to set up your integration with SSO in our Build a Single Sign-On (SSO) integration guide.


This guide series contains the following parts:

  • Prepare your SCIM API service: Prepare a SCIM-compliant API server to host your SCIM service, and test it to make sure it’s functional.
  • Configure Okta to your SCIM API service: Use Okta to make SCIM requests to your SCIM API service by creating and configuring an Okta SCIM integration from the Admin Console.
  • Test your Okta SCIM integration: Test that your SCIM app can handle requests to create, read, update, and delete (CRUD) user profile information. Also test that your app can run through our Okta Integration Network (OIN) quality assurance test cases.

See also

After using these guides, and preparing and testing your SCIM integration, you may want to make it public. To do so, follow the steps in our Submit an app integration guide to have it published in the Okta Integration Network (OIN) catalog (opens new window).

Next steps

Now that you know what these guides cover, you can get started by Preparing your SCIM API service.