Postman
Exploring and testing SailPoint APIs with Postman.
SailPoint publishes Postman collections so you can authenticate once and explore every endpoint interactively before writing code.
- Official Postman collections available
- Set OAuth once via environment variables
- Explore endpoints interactively
- Great for learning and debugging
Postman is the fastest way to learn and test the SailPoint API without writing code. SailPoint publishes Postman collections covering the endpoints; you import a collection, configure an environment with your tenant and OAuth credentials, and fire real requests interactively, inspecting responses as you go.
Getting set up
- 1. Import the collection for the API you are targeting.
- 2. Create an environment with variables for your tenant URL and OAuth client credentials.
- 3. Authenticate once, obtain a token (often scripted in the collection) so subsequent calls carry it automatically.
- 4. Explore, run list, get and action requests, adjusting filters and bodies.
Why start in Postman
Interactively hitting the API teaches you the shape of the payloads, which filters work, and how errors look, far faster than reading docs alone. You can confirm exactly the request you need, then translate that proven call into your SDK or application code with confidence.
From Postman to production
Treat Postman as the prototyping stage: get the request right, understand the response, verify your filter and pagination, then move the logic into maintainable code (ideally via the SDK). Keep the collection around as living documentation and a debugging tool.
Common pitfalls
- Storing real secrets in a shared collection, use environment variables and keep them private.
- Testing only the happy path, exercise error and pagination cases too.
- Stopping at Postman instead of moving proven calls into code.