Test APIs

Test endpoints in this reference

Each endpoint page in this reference includes a Try It console. To use it:

1. Enter your API key as the Username and leave the Password blank. Use the Event API key for event and supported live-content endpoints, and the User API key for everything else.
2. Select the Base URL that matches your Blueshift region.
3. Fill in the request parameters and click Try It.

For details on API keys and base URLs, see Authorization.

Postman collection

Blueshift maintains a Postman collection containing the full set of API calls. Use it to explore endpoints, build requests, and develop integrations without writing code.

Set up the collection

1. Click Run in Postman above to fork the collection into your Postman workspace.
2. Open the collection and select an endpoint.
3. In the Authorization tab, choose Basic Auth and enter your API key as the Username. Leave the Password blank. See Authorization for which key to use.
4. Set the request URL to the base URL for your Blueshift region:
   • US & Rest of the world: https://api.getblueshift.com
   • EU: https://api.eu.getblueshift.com
5. Fill in the request body or query parameters and send the request.

💡

Pro tip: Use environment variables

Save your API key and base URL as Postman environment variables so you can switch between accounts and regions without editing each request.

💬

Need help? For support, see Get in touch.