Create API Keys

April 28, 2017 Contributors

Before you can use the SparkPost REST APIs or SMTP injection, you will need to have a valid SparkPost API key. Below are the steps you will need to create a SparkPost API key.

IMPORTANT! Make sure to copy and paste the API key when it is displayed after saving. The whole API key is shown ONE TIME ONLY. After navigating away from that page recovery of a lost key is impossible. Keep your API keys in a safe and secure place. Treat them like passwords and never share them with anyone.

# Define the API Key:

Click on the Account section of the dashboard and then ‘API & SMTP’ to create an API key. You’ll use this key to authorize API requests or to authenticate SMTP injection. You may not need to select all permissions for your particular integration needs. It is always best practice to ONLY choose permissions which are necessary for your integration, but if you aren’t sure which permissions you might not need, we recommend you simply “select all” permissions.

  1. Click the “ADD API KEY” button to save this information and generate the API key
  2. Choose which permissions you want the API key to have. If you wish to change which permissions are available for a given API key, you may do so.
  3. Name the API key​Note: After the key has been created, you will only be able to see the name of the key, it’s permissions, and the first four characters.
  4. You do not need to configure the API key for subaccounts, unless you wish to use subaccounts. More information on subaccounts can be found in this article.

You have now completed the account configuration and obtained an API Key. If your sending domain has been verified you are ready to send your first email using SparkPost!

Note: If you are using the “Allowed IPs” feature, not all web hosting services will let you determine what IP API calls are made from, even if you subscribe to ‘dedicated IP’ services they provide. Please make sure you have control over the outgoing IP before utilizing this feature.