Stannp API FAQs

1.   What is an API?

API stands for Application Programming Interface. An API is a software intermediary that allows two applications to talk to each other.  In other words, an API is the messenger that delivers your request to the provider that you’re requesting it from and then returns the response back to you.

More specifically, our APIs provide programmatic access to your Stannp Bulk Mailer account and you can configure campaigns, feed data and trigger mail pieces to be dispatched using simple yet secure HTTP requests.

Don't miss the integral API document, put together by our tech experts, offering a guide on Stannp.com's API https://www.stannp.com/direct-mail-api. 

2.   How secure is the Stannp API?

Our API is secure because every API call to our service requires authenticating. This is simply done by passing your unique API key along with each request. All API requests must be made over HTTPS so they are encrypted. Any requests made over HTTP will fail and could suspend your API key.

3.   What do I need to be able to use the Stannp API?

First of all, you need to know your API Key. Second, you need to take a look at the API Documentation to know the format and parameters of the HTTPS requests. Third, you need to have a way of firing the requests: simple get requests like the one above can be ran in your browser. You can also use the command line or a programming language to make those requests or an application like Postman.

4.   Where can I find my API Key?

It's simply settings -> API

5. Where can I find the API Documentation?

Follow the link to Stannp.com's API Documentation here https://www.stannp.com/direct-mail-api.                 

6.  When is it appropriate to use the API?

The API is perfect for any kind of automation. It’s basically a way to use our service without the need to log into a dashboard and click buttons. For example instead of manually importing data you could set up a script that will do it for you.

You will need a good technical understanding of how HTTP API requests work and will have to write script and implement them yourselves.

7. Can I use the API without writing code?

Not really, however you can set up automation by using our official extensions for common software such as Magento, Woo Commerce, etc. You could also use a service like Zapier which connects API together. Learn about 'Stannp and Zapier here'.  

8. Do you have a sandbox or can I test the API without actually sending direct mailing?

You can add an optional parameter “test=true” when creating  a postcard or letter to be able to get the sample pdf with it actually being sent and without affecting your balance. Tests do not show in the Reporting section. We do not have sandbox accounts.

Tests do not show in the reporting section. However, you can see every request you send through in the API request log, you can access this by this URL here: https://dash.stannp.com/api-log or, by settings -> API request log. This is a particularly great tool for reviewing what we receive from your API requests.

9.  What are the Stannp API response codes and what do they mean?

All API requests return a JSON response and adhere to HTTP response codes.

Although those mentioned below are the main response codes, there are a few more than can come up. Read more on on our detailed article https://knowledge.stannp.com/what-does-the-api-response-code-mean.  

10. What can I use the Stannp API for?

You can use the API to:

• Check your current balance
• Create single postcards
• Create single letters
• Create a pre-mail merged letters
• Perform operations on recipients (get, create, delete, list)
• Check an address is valid 
• Import a data file
• Perform operations on groups (get, create, delete, list)
• Add recipients to a group
• Get a reporting summary
• List mail pieces
• Perform operations on campaigns (get, create, delete, list)