Authentication
To access the Poplar API you'll need to use either a Test or Production Access Token. These can be found and generated on the API page of your account:
Never give your Access Token to a third party
Your Access Token can give access to your private Poplar data and should be treated like a password. If you believe your Access Token has been compromised then it can be reset from the API Keys tab in the left navigation.

Using your Access Token

To use your Token, simply provide it as part of the authorization header when you make a request. Tokens use the bearer authorization header when you make a request.
1
curl \
2
-s https://api.heypoplar.com/v1/me \
3
-H 'Authorization: Bearer <access token>' \
4
-H 'Accept: application/json'
Copied!
If you are using any of our client SDK's then this process is automated during initialization. This means that you do not need to specify this header explicitly.

Testing your Access Token

When creating a new access token, you have the option to create a production or test access token.
Test access tokens are intended to support the testing of API integrations and can be identified by the test prefix. When using a test token, mailings will be generated in your account however they will not be mailed.
From your campaigns History tab, you can easily filter between test and production mailings:
Last modified 6mo ago