v1-v3 APIs have been deprecated.
Although these APIs are not shut off yet, all new development with APIs should use the newest version of our API if available, and the version /1 in all other cases. These later versions are based on RESTful principles, secured by OAuth 2.0, and provide JSON messages, search, pagination, sorting, and filtering.
Postman Collections
Download a Postman Collection that provides all of the calls available for each of our OneLogin resources.
Try it out with a test account first: Start off with using a Postman Collection with a test OneLogin account and API key. Once you’ve familiarized yourself with the API’s behavior, switch over to using your production OneLogin account and API key.
Users
Download the Postman Collection for the Users API
To use this Postman Collection, you must define the following environment variables:
|
Start out with using this Postman Collection with a sandbox host. Once you’ve familiarized yourself with the API’s behavior, move over to using it with a production account and set this value to |
|
Set this to the API key for your account. |
|
Set this to |
|
Set this to the user ID for which you want to make a request. |
|
Set this to the username for which you want to make a request. |
Roles
Download the Postman Collection for the Roles API
To use this Postman Collection, you must define the following environment variables:
|
Start out with using this Postman Collection with a sandbox host. Once you’ve familiarized yourself with the API’s behavior, move over to using it with a production account and set this value to |
|
Set this to the API key for your account. |
|
Set this to |
|
Set this to the role ID for which you want to make a request. |
SAML Assertion
Download the Postman Collection for the SAML Assertion API
To use this Postman Collection, you must define the following environment variables:
|
Start out with using this Postman Collection with a sandbox host. Once you’ve familiarized yourself with the API’s behavior, move over to using it with a production account and set this value to |
|
API key assigned to the OneLogin account that contains the user and app for which you want to generate a SAML token. |
|
Username of the OneLogin user accessing the app for which you want to generate a SAML token. |
|
Password of the OneLogin user accessing the app for which you want to generate a SAML token. Required. |
Delegated Auth
Download the Postman Collection for the Delegated Auth API
To use this Postman Collection, you must define the following environment variables:
|
Start out with using this Postman Collection with a sandbox host. Once you’ve familiarized yourself with the API’s behavior, move over to using it with a production account and set this value to |
|
Set this to the API key for your account. |
|
Set to the email of the app user you want to authenticate in OneLogin. |
|
Set to the password of the app user you want to authenticate in OneLogin. |
Invite Link
Download the Postman Collection for the Invite Link API
To use this Postman Collection, you must define the following environment variables:
|
Start out with using this Postman Collection with a sandbox host. Once you’ve familiarized yourself with the API’s behavior, move over to using it with a production account and set this value to |
|
Set this to the API key for your account. |
|
Set to the email address associated with the API key being used to make the call. |
|
To email the invite link to an address other than the email value, provide a personal_email value. |
Events
Download the Postman Collection for the Events API
To use this Postman Collection, you must define the following environment variables:
|
Start out with using this Postman Collection with a sandbox host. Once you’ve familiarized yourself with the API’s behavior, move over to using it with a production account and set this value to |
|
Set this to the API key for your account. |
|
Set this to |
|
Set this to the event ID for which you want to make a request. |
Accounts
Download the Postman Collection for the Accounts API
To use this Postman Collection, you must define the following environment variables:
|
Start out with using this Postman Collection with a sandbox host. Once you’ve familiarized yourself with the API’s behavior, move over to using it with a production account and set this value to |
|
Set this to the API key for your account. |
|
Set this to |
|
Set this to the account ID for which you want to make a request. |
Groups
Download the Postman Collection for the Groups API
To use this Postman Collection, you must define the following environment variables:
|
Start out with using this Postman Collection with a sandbox host. Once you’ve familiarized yourself with the API’s behavior, move over to using it with a production account and set this value to |
|
Set this to the API key for your account. |
|
Set this to |
|
Set this to the group ID for which you want to make a request. |
Have a Question?
Found a problem or a bug? Submit a support ticket.
Looking for walkthroughs or how-to guides on OneLogin's user and admin features? Check out the documentation in our Knowledge Base.
Have a product idea or request? Share it with us in our Ideas Portal.