⚠️ 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 Postman collection Download the Postman Collection for the Users API To use this Postman Collection, you must define the following environment variables:

`{{host}}`	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 `http://api.onelogin.com`.
`{{api_key}}`	Set this to the API key for your account.
`{{password}}`	Set this to `x`.
`{{user_id}}`	Set this to the user ID for which you want to make a request.
`{{username}}`	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:

  <tr>
     <td>
        <p><code>&#123;&#123;host&#125;&#125;</code></p>
     </td>
     <td>
        <p>Start out with using this Postman Collection with a sandbox host.</p>
        <p>Once you've familiarized yourself with the API's behavior, move over to using it with a production account and set this value to <code>http://api.onelogin.com</code>.</p>
     </td>
  </tr>
  <tr>
     <td>
        <p><code>&#123;&#123;api_key&#125;&#125;</code></p>
     </td>
     <td>
        <p>Set this to the API key for your account.</p>
     </td>
  </tr>
  <tr>
     <td>
        <p><code>&#123;&#123;password&#125;&#125;</code></p>
     </td>
     <td>
        <p>Set this to <code>x</code>.</p>
     </td>
  </tr>
  <tr>
     <td>
        <p><code>&#123;&#123;role_id&#125;&#125;</code></p>
     </td>
     <td>
        <p>Set this to the role ID for which you want to make a request.</p>
     </td>
  </tr>

## SAML Assertion Download Postman collection

Download the Postman Collection for the SAML Assertion API To use this Postman Collection, you must define the following environment variables:

  <tr>
     <td>
        <p><code>&#123;&#123;host&#125;&#125;</code></p>
     </td>
     <td>
        <p>Start out with using this Postman Collection with a sandbox host.</p>
        <p>Once you've familiarized yourself with the API's behavior, move over to using it with a production account and set this value to <code>http://api.onelogin.com</code>.</p>
     </td>
  </tr>
  <tr>
     <td>
        <p><code>&#123;&#123;api_key&#125;&#125;</code></p>
     </td>
     <td>
        <p>API key assigned to the OneLogin account that contains the user and app for which you want to generate a SAML token.</p>
     </td>
  </tr>
  <tr>
     <td>
        <p><code>&#123;&#123;username&#125;&#125;</code></p>
     </td>
     <td>
        <p>Username of the OneLogin user accessing the app for which you want to generate a SAML token.</p>
     </td>
  </tr>
  <tr>
     <td>
        <p><code>&#123;&#123;password&#125;&#125;</code></p>
     </td>
     <td>
        <p>Password of the OneLogin user accessing the app for which you want to generate a SAML token. Required.</p>
     </td>
  </tr>
  <tr>
     <td> </td>
     <td> </td>
  </tr>

## Delegated Auth Download Postman collection

Download the Postman Collection for the Delegated Auth API To use this Postman Collection, you must define the following environment variables:

  <tr>
     <td>
        <p><code>&#123;&#123;host&#125;&#125;</code></p>
     </td>
     <td>
        <p>Start out with using this Postman Collection with a sandbox host.</p>
        <p>Once you've familiarized yourself with the API's behavior, move over to using it with a production account and set this value to <code>http://api.onelogin.com</code>.</p>
     </td>
  </tr>
  <tr>
     <td>
        <p><code>&#123;&#123;api_key&#125;&#125;</code></p>
     </td>
     <td>
        <p>Set this to the API key for your account.</p>
     </td>
  </tr>
  <tr>
     <td>
        <p><code>&#123;&#123;email&#125;&#125;</code></p>
     </td>
     <td>
        <p>Set to the email of the app user you want to authenticate in OneLogin.</p>
     </td>
  </tr>
  <tr>
     <td>
        <p><code>&#123;&#123;password&#125;&#125;</code></p>
     </td>
     <td>
        <p>Set to the password of the app user you want to authenticate in OneLogin.</p>
     </td>
  </tr>

## Invite Link Download Postman collection

Download the Postman Collection for the Invite Link API To use this Postman Collection, you must define the following environment variables:

  <tr>
     <td>
        <p><code>&#123;&#123;host&#125;&#125;</code></p>
     </td>
     <td>
        <p>Start out with using this Postman Collection with a sandbox host.</p>
        <p>Once you've familiarized yourself with the API's behavior, move over to using it with a production account and set this value to <code>http://api.onelogin.com</code>.</p>
     </td>
  </tr>
  <tr>
     <td>
        <p><code>&#123;&#123;api_key&#125;&#125;</code></p>
     </td>
     <td>
        <p>Set this to the API key for your account.</p>
     </td>
  </tr>
  <tr>
     <td>
        <p><code>&#123;&#123;email&#125;&#125;</code></p>
     </td>
     <td>
        <p>Set to the email address associated with the API key being used to make the call.</p>
     </td>
  </tr>
  <tr>
     <td height="20">
        <p><code>&#123;&#123;personal_email&#125;&#125;</code></p>
     </td>
     <td>
       <p>To email the invite link to an address other than the email value, provide a personal_email value.</p>
    </td>
 </tr>

## Events

Download the Postman Collection for the Events API To use this Postman Collection, you must define the following environment variables:

  <tr>
     <td>
        <p><code>&#123;&#123;host&#125;&#125;</code></p>
     </td>
     <td>
        <p>Start out with using this Postman Collection with a sandbox host.</p>
        <p>Once you've familiarized yourself with the API's behavior, move over to using it with a production account and set this value to <code>http://api.onelogin.com</code>.</p>
     </td>
  </tr>
  <tr>
     <td>
        <p><code>&#123;&#123;api_key&#125;&#125;</code></p>
     </td>
     <td>
        <p>Set this to the API key for your account.</p>
     </td>
  </tr>
  <tr>
     <td>
        <p><code>&#123;&#123;password&#125;&#125;</code></p>
     </td>
     <td>
        <p>Set this to <code>x</code>.</p>
     </td>
  </tr>
  <tr>
     <td>
        <p><code>&#123;&#123;event_id&#125;&#125;</code></p>
     </td>
     <td>
        <p>Set this to the event ID for which you want to make a request.</p>
     </td>
  </tr>

## Accounts Download Postman collection

Download the Postman Collection for the Accounts API To use this Postman Collection, you must define the following environment variables:

  <tr>
     <td>
        <p><code>&#123;&#123;host&#125;&#125;</code></p>
     </td>
     <td>
        <p>Start out with using this Postman Collection with a sandbox host.</p>
        <p>Once you've familiarized yourself with the API's behavior, move over to using it with a production account and set this value to <code>http://api.onelogin.com</code>.</p>
     </td>
  </tr>
  <tr>
     <td>
        <p><code>&#123;&#123;api_key&#125;&#125;</code></p>
     </td>
     <td>
        <p>Set this to the API key for your account.</p>
     </td>
  </tr>
  <tr>
     <td>
        <p><code>&#123;&#123;password&#125;&#125;</code></p>
     </td>
     <td>
        <p>Set this to <code>x</code>.</p>
     </td>
  </tr>
  <tr>
     <td>
        <p><code>&#123;&#123;account_id&#125;&#125;</code></p>
     </td>
     <td>
        <p>Set this to the account ID for which you want to make a request.</p>
     </td>
  </tr>

## Groups

Download the Postman Collection for the Groups API To use this Postman Collection, you must define the following environment variables:

`{{host}}`	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 `http://api.onelogin.com`.
`{{api_key}}`	Set this to the API key for your account.
`{{password}}`	Set this to `x`.
`{{group_id}}`	Set this to the group ID for which you want to make a request.