See api-docs Menu

Dev Overview of API /1

Welcome to the latest version of the OneLogin Cloud Directory API: version/1. All new development should use this version of the API.

API version /1 is based on RESTful principles, is secured by OAuth 2.0, and provides JSON messages, search, pagination, sorting, and filtering.


User Resource

Get Users

Get User by ID

Get Apps for a User

Get Roles Assigned to a User

Get Custom Attribute Fields

Create User

Delegate Authentication

Update User

Assign Roles to a User

Remove Roles for a User

Set Password Using Cleartext

Set Password Using SHA-256

Set Custom Attribute Values for a User

Set User State

Log User Out

Lock User Account

Delete User

Custom Login Pages

Log in User via API

Create Session Login Token

Verify Factor

Session Via API Token

OAuth 2.0 Tokens

Generate Tokens

Refresh Tokens

Revoke Tokens

Get Rate Limit

SAML Assertions

Generate SAML Assertion

Verify Factor


Get Roles

Get Role by ID


Event Resource and Types

Get Events

Get Event Types

Get Event by ID

Create Event


Get Groups

Get Group by ID


Generate Invite Link

Send Invite Link

Embed Apps

Embed Apps

Have a Question?

Have a how-to question? Seeing a weird error? Ask us about it on StackOverflow.

Found a bug? Submit a support ticket.

Have a product idea or request? Share it with us in our Ideas Portal.

StackOverflow discussions about "[onelogin] api"

  • 6

    A: OneLogin REST API with PowerShell's Invoke-RestMethod

    Answered Sep 05 2016

    saved to `$global:helpme" break } Then, wrap all of your Invoke-RestMethod calls in a try Catch block like this. try { $e = Invoke-WebRequest '$id … you found in fiddler. With those two changes, here's my request and the response $Splat = @{ Method = 'PUT' Uri = ' …

  • 4

    Q: AWS API credentials with OneLogin SAML and MFA

    Asked Oct 30 2016

    fully re-authenticate to OneLogin (including MFA) every 60 minutes as the AWS temporary credentials expire. I think that won't fly - our users are accustomed to permanent API credentials tied to a … We want to allow our users to retrieve a set of temporary CLI credentials for a given AWS role by signing in to OneLogin with password and MFA. We have a working solution, but it requires the user to …

  • 2

    A: Refresh token is valid for 45 days in oneLogin

    Answered Aug 17 2016

    Nope. Refresh token lifespan is measured from when it gets created. If you create a new one via refresh it'll 'live' for 45 days. The allows you to hold on to the tokens and still be able to make a n …

  • 2

    Q: OneLogin REST API with PowerShell's Invoke-RestMethod

    Asked Sep 04 2016

    I'm working against the OneLogin REST API and can't seem to get any calls with a PUT method working. When I test in Postman, I can pass a raw JSON body like this: { "role_id_array … ": [ 115028 ] } to the endpoint: This works just fine. However, when I attempt to do the same with PowerShell's …

  • 2

    Q: OneLogin session_via_api_token and Chrome

    Asked Nov 14 2016

    I am getting a session token via an ajax call. This in turn calls the API method $.post("onelogin.ashx?action=sessiontoken", data, function (s …