The Siteleaf API requires all requests to be authenticated via Basic Auth with an API Key and Secret. These can be found on your account page in the web app, or programmatically via the API as described below.

Get an API Key and Secret

The authentication endpoint requires Basic Auth with a users email and password, and is the only endpoint that accepts this method of authentication. It returns the unique Key and Secret that can be used to authenticate with the rest of the Siteleaf API.


POST https://api.siteleaf.com/v2/auth


$ curl --user "email:password" \
       --request POST https://api.siteleaf.com/v2/auth


Status: 200 OK
  "api_key": "pgYWJZyGvCY60Eys...",
  "api_secret": "m8IibnCkXISebc9b..."

Using your API credentials

Once you have your API Key and Secret, you can use these to authenticate on all other endpoints with Basic Auth. Use your API Key in place of username, and API Secret in place of password, combined with a single colon (:) as shown in the example below.


$ curl --user "api_key:api_secret" \
       --request GET https://api.siteleaf.com/v2/sites

Help improve this page