Create custom IDP

Now that you’ve collected your details and created the attribute map, you can create the custom IDP in Identity Cloud.

To complete this task, we will:

  1. Get a token to authorize your configuration
  2. Configure your custom IDP

In this section, you’ll make RESTful API calls to the Identity Cloud using your platform or language of choice. We provide complete, pre-populated sample calls in cURL format.

New to making API calls?

Get an access token

In order to create your custom IDP, you must first obtain an access token to authorize your configuration. To do this, you’ll make a call to the Hosted Login configuration endpoint: /login/token

This call requires Basic Authorization. To create the authorization code for this call, your configuration_client_id and configuration_client_secret must be combined with a colon in between (id:secret) and then base64 encoded.

Find my configuration client id and secret
How to create the authorization code in Postman
curl -X POST \ \
	-H 'Authorization: Basic AUTHORIZATION_CODE' \
	-H 'Content-Type: application/x-www-form-urlencoded' \
	-d 'grant_type=client_credentials' \
	-d 'scope=*:v2/config/**'

The scope in this case will grant your token full read/write access to all custom provider endpoints, which include the v2 marker.

Enter the access_token from your call’s response below. We’ll use this in next steps.

See example of an access token

Create your custom IDP

Now that you have an access token, you can use it to make the following Hosted Login configuration call for creating your custom IDP.

Unlike the previous /login/token call, which required Basic Authorization with an ID and secret, these calls require Bearer Token Authorization with the access token you just provisioned. This token lasts one hour - when it expires, you can provision a new one.

Call the /custom-providers endpoint with POST method to create your custom IDP.

Did you skip a step? Please go back and SELECT THE PROTOCOL to see your API call here.

In order for the call to be pre-populated with your values, you must complete all required fields in the Gather Your Details section.

Response Status Response Body Outcome
201 Created Empty The call was successful and your custom IDP has been created.

Troubleshooting Tips