Blog
Compass
Getting Started
Authentication
API Versioning
V3 API Standard Collection Parameters
Access Requests
Account Activities
Certifications
Certification Summaries
Public Identities
Public Identities Config
Requestable Objects
Saved Search
Scheduled Search
Search
Password Dictionary
Tagged Objects
Role Insights
Personal Access Tokens
Accounts
Non-Employees
OAuth Clients
Access Requests
Account Activities
Certifications
Certification Campaigns
Managed Clusters
Notifications
Public Identity Config
Requestable Objects
Sources
Non-Employee Lifecycle Management
Service Desk Integration
Task Management
Triggers

Get Started with IdentityNow APIs

NOTE: To use SailPoint SaaS APIs, you must have an org provisioned and bootstrapped with identities, sources/applications, and entitlements/access profiles/roles.

To get started, you will need an API client:

  • As an ORG_ADMIN, browse to your API Management Admin Page on https://{org}.identitynow.com/ui/admin/#admin:global:security:apimanagementpanel and create an API client.
  • Retrieve an Access Token from https://{org}.identitynow.com/ui/session.
  • Use POST https://{org}.api.identitynow.com/beta/oauth/client.

How to Use the Developer Portal

For more information about SailPoint SaaS Platform authentication, see API Authentication

  • SailPoint supports API v3, and beta. Use the most recent version of the API, when possible.
  • There is a limitation of 100 requests per access token per 10 seconds for V3 API calls through the API gateway.
  • Each API resource requires a specific level of authorization attached to your accessToken. Please review the authorization constraints for each API resource.
  • For detailed information about using /search API, see this Compass Article.

Use an API Tool

From the SailPoint SaaS, and Early Access header pages, you can download the full specifications and import them into an API tool, such as POSTMAN.

Use Request Makers in the Developer Portal

This portal includes HTTP request makers to invoke APIs without using a tool such as POSTMAN. You must retrieve an accessToken and add it in the header for as a Bearer token.

The Code Generation tab for each HTTP Request Maker provides code examples of how to invoke the API, e.g. CURL, Python, etc.

Get a token
Send requests directly from the browser (CORS must be enabled)
$$.env
1 variable not set
org