Because we use OAuth 2.0 you will need to make sure you select “OAuth 2.0” under TYPE and enter your Cerkl API Client ID and Client Secret in the “Authorization” tab after you select any of our requests. Name it anything you like and set the Access Token URL to api.cerkl.com/v3/oauth/Token and hit “Request Token” to authenticate with our servers. If successful you will be provided with an access token and you can start using our API in Postman.
For more details on API authorization in Postman, see this page.
Making requests with Postman is easy. Once you’re authorized with a shiny new OAuth 2.0 access token and have selected a request to try out, hitting “send” will make the request against our servers. GET and DELETE requests generally don’t require any inputs (unless you’d like to control the paging of results). In contrast, POST and PUT requests require a valid request body in order to create/update resources in your Cerkl instance via the API.
To learn more about how to construct valid Cerkl API v3 request bodies, check out our requests documentation and our API Reference. You can also grab usable source code for any of our requests directly from Postman using the “code” button in each request tab.
Using this feature you can quickly prototype calls to Cerkl’s API in your codebase using a variety of languages. Need some PHP code instead of cURL? No problem! Postman has that covered.
These generated request code snippets can be very helpful in the initial stages of building out integrations with Cerkl. If you’re looking for a more fully-featured option to add Cerkl API calls into your codebase you should check out our SDKs that we generate from our OpenAPI specification. We support a small number of them, but Swagger’s CodeGen tool makes it easy to generate an API client for many different languages and platforms.
