# Getting started

Getting started with the Sublime Ads API is easy.

First you will need your API key. This can be found on your account page, under API Keys.

API Keys

To copy, just click/tap the box and use the usual copy command for your operating system.

Each time you call the API you need to append your token in your query string.

We'll call the API Key a "token" from now on to avoid confusion.

If you'd like to keep your API Keys separate for each app or integration you can do this by adding a name and pressing Create in the dialog.

Below you can see an example of multiple API Keys. Note that the Default key cannot be deleted. You can, however, always regenerate a key - just in case you wrote it down on a piece of paper and left it in the coffee shop ☕️ (it happens!)

Additional API keys

# Hello Sublime Ads

To test your token you can call the following endpoint:

https://sublimeads.com/api/hello_key

Pass in your token as a URL parameter:

https://sublimeads.com/api/hello_key?token=yourTokenGoesHere

On success the API will return a 200 OK and a message welcoming you with your given name. A timestamp is also provided. Here is an example reply:

{"message":"Hello from Sublime Ads, Vincent! 🖖","now":"2020-06-11T17:17:34.026Z"}

Feel free to use this endpoint to check for availability of Sublime Ads and validity of your token.