The dailystory Developer Hub

Welcome to the dailystory developer hub. You'll find comprehensive guides and documentation to help you start working with dailystory as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Create and Use an API Token

To use the DailyStory REST API you will first need an API token. To create an API token login to DailyStory and then go to Account Settings > API Tokens:

​From here you can click the "Add API Token" to generate a new token or revoke existing tokens.


Best Practice

As a best practice, we recommend creating separate tokens for each application integrated with DailyStory.

Using the API Token in a Request

All requests made to the DailyStory API require 2 pieces of information:

  • API end point
  • API token

API End Point

Use of the API requires you to use a specific data center identifier when making an API request. When logged in to DailyStory this can be determined by examining the URL.

For example, uses the us-1 data center. Whereas uses the uk-3 data center.


Data Center required in the URL

All API requests are made using the URL that includes your data center, e.g.

API Token

The DailyStory API requires, and only supports, HTTPS requests using Basic Authentication. The authentication token should be set as the Password and the Username set to "api".

GET request example

curl --user api:[YOUR API TOKEN]

POST request example

curl -X POST --user api:[YOUR API TOKEN] -H "Content-Type: application/json" -d "{\"email\":\"[email protected]\"}"

API Response

The API will always respond with a JSON response. Even in the case of errors. Typically the API response will be wrapped in a Response object. For example, a request to the campaigns end-point (/api/v1/campaigns) returns:

        "campaigns": [{...}]

The Status, along with the HTTP status code, indicates if the request was processed successfully. If an error occurred, the Message will contain details about the error.

The Response may contain multiple values.

Tips and Recommendations

Be sure and set the Content-Type to application/json in all POST requests.

Updated 4 months ago

Create and Use an API Token

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.