Before making any REST API calls, your account needs to be authenticated. For this example, we will demonstrate our API calls using Postman, however this would be coded programmatically in whichever language your website or service is coded in, such as: PHP, JAVA, c#.NET, etc. Before beginning the authentication process, be sure your IP address has been whitelisted.
1. Open the Postman application, or the REST application of your choice.
2. Open https://api.dev.listrak.com/sms in a browser window.
3. In the browser window, navigate to the Authentication Tab on the left-hand side.
4. Copy the Token Endpoint URL (https://auth.listrak.com/OAuth2/Token).
5. Navigate to the Postman app.
6. Paste the copied URL into the Enter Request URL box.
7. Select Post from the drop-down menu.
8. Click Save to update and save the Authentication request for later use.
9. In the Save Request pop-up, enter the following:
- A Name
- Create and Name a Collection to hold the API Requests
- Click the check mark following the collection name
10. Click Save.
11. Navigate to the Body tab.
12. Click the x-www-form-urlencoded radio button.
13. Enter grant_type for the first key.
14. Enter client_credentials for the value of the first key.
15. Enter client_id for the second key.
16. Navigate to where you've saved your Client Secret and ID.
17. Copy the Client ID.
18. Navigate to Postman.
19. Paste the Client ID in the value for the second key, client_id.
20. Enter client_secret for the third key.
21. Navigate to where you've saved your Client Secret and ID.
22. Copy the Client Secret.
23. Navigate to Postman.
24. Paste the Client Secret in the value for the third key, client_secret.
25. Click Save.
26. Click Send to receive your bearer access token.
27. Copy the Bearer Access Token.
28. Navigate to the Authorization tab.
29. Select Bearer Token from the drop-down menu.
30. Paste the copied Bearer Token from step 27 into the token text box.
You are now authenticated and ready to make API calls within Postman!