REST API documentation#
The base URL for all API requests is: https://api.sendmachine.com.
All endpoints use stateless authentication and support both Bearer Token and HTTP Basic Authentication.
To use the Sendmachine API, you need an API key associated with your account. You can generate and manage API keys from your Sendmachine dashboard. After creating a key, copy it and use it to authenticate all API requests.
Note
Your API key grants full access to your account. Keep it secret and do not expose it in client-side applications.
Authentication#
Bearer Token
To authenticate using a Bearer Token, include your API key in the Authorization header:
Authorization: Bearer YOUR_API_KEY
Basic HTTP Authentication
If you prefer HTTP Basic Authentication, use:
Username: the API username shown in the Integrations API menu (not your account email)
Password: YOUR_API_KEY
Example
curl "https://api.sendmachine.com/ping" -H "Authorization: Bearer YOUR_API_KEY"
Scopes & Permissions#
Each API resource requires specific scopes. Refer to the documentation of each resource to see which scopes are needed.
Request and Response format#
The preferred request Content-Type is application/json. Responses are returned as application/json with HTTP status 200 unless noted otherwise.
Code samples#
API Client#
An official API client can be found here: Sendmachine/SendmachineApiClient