API Reference

The Eclectic API lets you send messages, check delivery status and receive real-time webhook events. Requests are made over HTTPS and authenticated with a bearer token.

Contact the team before using the API

Before you start using the API you must contact the Eclectic team to enable your access and get your token. Reach out to us to coordinate the integration.

Base URL

All API requests are made to the following base URL. Every endpoint described in this reference is relative to it.

http

https://api.try-eclectic.com/v1

Authorization

Authenticate every request by sending your API token as a bearer token in the Authorization header.

http

Authorization: Bearer test_gshuPaZoeEG6ovbc8M79w0QyM
Content-Type: application/json

Format and Headers

The API accepts and returns JSON. Always send the Content-Type: application/json header on requests with a body.

Rate Limits

Requests are rate limited per API token. If you exceed the limit you will receive a 429 response and should retry after a short delay.

Errors

Errors are returned with the appropriate HTTP status code and a JSON body describing what went wrong.

json

{
  "errors": [
    {
      "code": "unauthorized",
      "message": "Invalid or missing API token"
    }
  ]
}