Identity Cloud REST API Postman Collection

If you're looking for a quick way to get started with the Identity Cloud REST APIs, you might want to download our new Postman Collection, something you can do by clicking the button below:

Download

Clicking that button downloads a .ZIP file (identity-cloud-rest-apis-postman-collection.zip) that, in turn, contains these two files:

  • Identity Cloud REST APIs.postman_collection.json. The Postman collection itself (including sample code and brief documentation for all the endpoints).
  • Identity Cloud REST API Postman Environment.postman_environment.json. A Postman environment to accompany the collection.

Import those files into Postman and you're good to go.


A Note About the Postman Environment

The Postman environment is a list of variables representing values used repeatedly throughout the Postman collection; for example, instead of typing https://v1.api.us.janrain.com over and over again, you can simply enter https://v1.api.us.janrain.com as the value of the identityDomain variable. From that point on (as long as you're using the Identity Cloud environment, of course), Postman will automatically replace each instance of with https://v1.api.us.janrain.com.

Just keep in mind that the Postman environment you download will include all the variable names, but it won't have any of the variable values:

Why did we leave all those values blank? You got it: because we don't know your apiClientId or your apiKey. That's information you'll need to fill in yourself. (Or not: after all, you don't have to use the Postman environment.) If you aren't sure what goes where, the following table provides the name, a brief description, and a sample value for each variable in the Postman environment:

Variable

Sample Value

Description

adminAccessToken

S6aIWJLKAR5cozxIja2m71X1
rn58d0N3OveGiN5mGuEoyML
BLuwEZr7em3sSjx1L

Access token required to call the OAuth/OpenID Connect APIs.

apiClientId

d8mks2buzmczbnfc8zjdmvvz8
9ct3x6n

Unique identifier assigned to an API client. (In the Postman collection, this typically refers to a client with the login feature.) You can find the ID for a client by locating that client on Console’s Manage Properties page.

apiKey

54gdh9a416002b7ed4137
37h63hdhsa4

Unique identifier for your Social Login application. This the value assigned to the rpx_app_id setting on Console’s Manage Application page.

appId

79y4mqf2rt3bxs378kw5479xdu

Unique identifier for your Identity Cloud application. You can find this value listed next to the Application Id header on Console’s Manage Application page.

configurationClientId

d0b077ce-c01e-4150-99d7-
f0eae7f00f78

Unique identifier of your configuration client. This value is used for the username setting when retrieving a configuration access token (adminAccessToken). To find this value, look for the confidential_client_id setting on Console’s Manage Application page.

configurationClientSecret

caTOargI2JKUTks-KPy2rt453ar
ZXhL1Zjy5cjjUUhagKz8U7lj8D
lauX6iF1wZ0kk54XxDHWkGaI
Mk98

Client secret for your configuration client. This value is used for the password setting when retrieving a configuration access token (adminAccessToken). To find this value, look for the confidential_client_secret setting on Console’s Manage Application page.

customerId

e0a70b4f-1eef-4856-bcdb-
f050fee66aae

Your organization’s Akamai customer ID. This ID can be found on Console’s Manage Application page next to the customer_id­ label.

directAccessClientId

b6ujaekqfsgr3def7mzbn859e
56hsgpr

Unique identifier of an API client that has been assigned the direct_access feature. You can find the ID for a direct_access client by looking on Console’s Manage Properties page.

directAccessClientSecret

36gtwq2guehu7yhqqtnwup
polraml

Client secret (i.e., password)  assigned to an API client that has the direct_access feature. You can find the secret for a direct_access client by locating the client on Console’s Manage Properties page, clicking the Actions icon next to the client name, and then clicking Edit

entityType

user

Name of the user profile database where your user accounts are stored. By default you are issued a single entity type: user. However, you can create additional entity types as needed.

API clients do not have to use the same entity type. To find the entity type assigned to a specific client, look for the user_entity_type setting in the API client’s General Settings section.

flow

standard

Name of the flow used by an API client. API clients do not have to use the same flow. To find the flow assigned to a specific client, look for the default_flow_name setting in the API client’s General Settings section.

flowVersion

20210406175001388696

Identifier (which is actually a timestamp) assigned to each version of a flow. You can find all the version numbers for a flow by using Console’s Registration Builder

API clients do not have to use the same flow version. To find the version of the flow assigned to a specific client, look for the default_flow_version setting in the API Client’s General Settings section. The value HEAD indicates that the API client automatically uses the most-recent version of the flow.

identityDomain

https://v1.api.us.janrain.com

Domain used when calling many of the Identity Cloud APIs.

locale

en-US

Language/locale primarily used when rendering Identity Cloud screens. The default value (and the only language included "out of the box") is en-US: US English.

loginPolicyId

0ba507a6-75a9-47e7-86b4-68c0a64f9f7a

Unique identifier fir a Hosted Login login policy. 

oidcClientId

d0b077ce-c01e-4150-99d7-f0eae7f00f78

Unique identifier for an OpenID Connect client. All three client types used by Hosted Login – public, confidential, and configuration – have a client ID.

oidcClientSecret

07s78-JcHxgQyylNpcvjbwOlX
QJrlxT8opScTyQY5mVyPjzhy3
CGbKKh6ekzK70GnqavSoc4Ai
wpJ6GyWZaopQ

Client secret (i.e., password) assigned to an OpenID Connect client. Only configuration clients and confidential clients have client secrets.

ownerClientId

y4xfg6f44msac3vepjjvxggzvt
3e3sk9

Unique identifier of an API client that has been assigned the owner feature. You can find the ID for an owner client by looking on Console’s Manage Properties page.

ownerClientSecret

9g345fazbvuzxkJH89p6dj5b
zqq5

Client secret (i.e., password)  assigned to an API client that has the owner feature. You can find the secret for an owner client by locating the client on Console’s Manage Properties page, clicking the Actions icon next to the client name, and then clicking Edit

registrationDomain

https://se-demos-gstemp.us-
dev.janraincapture.com

Also referred to as the “Capture” domain. This is the value assigned to the Registration Domain(s) setting on Console’s Manage Application page. The registration domain is used when calling the Entity and Entity Type APIs; the Authentication APIs; and the Legacy Client and Settings APIs.

socialLoginDomain

https://greg-stemp.rpxnow.com

Domain used when calling the Social APIs. Your social login domain is the value assigned to the Application Domain setting in the Social Login dashboard.

tokenPolicyId

8d537da1-afe3-4011-b458-
a2a8f9ba5b8a

Unique identifier of a Hosted Login token policy.

userAccessToken

CKTYZfelql9QKStDfx70Leb7
BfLZAXNC25WJOPlX8FrUEq
UxeAHpKudUkKhBloq6

Access token issued to an individual user following a successful authentication.