Authentication
All requests to the Authcrest API must be authenticated using an API key issued during account activation. API keys are scoped to specific permissions and should be treated as sensitive credentials. Never embed API keys in client-side code or public repositories.
API Key Format
Authcrest API keys follow the format ac_live_<key_id>_<secret>. Keys prefixed with ac_test_ may be used in the sandbox environment without incurring charges or sending real messages.
Request Authentication
Include your API key in the X-Authcrest-Key header on every request. All requests must be made over HTTPS. Requests over plain HTTP will be rejected.
API Endpoints
Response Format
All responses are returned as JSON. Successful requests return HTTP 200 or 202 with a response body. Error responses include a machine-readable error_code and human-readable message.
SMTP Relay Credentials
For applications that require SMTP rather than the API, use the following connection details. STARTTLS is mandatory. Plain connections are rejected at the server level.
Rate Limits
Rate limits are applied per API key. Growth plan accounts are limited to 100 requests per second. Professional and Enterprise accounts have limits configured during onboarding. Exceeding rate limits returns HTTP 429 with a Retry-After header.