Skip to main content
Authenticate requests with a server-side API key.
  1. In the app, go to Settings → API → “Create API key”.
  2. Copy the key and store securely.
curl -X GET \
  -H "Authorization: Bearer $API_KEY" \
  https://api.fluxomail.com/api/v1/sends/sends_123
Headers
HeaderTypeRequiredDescription
AuthorizationstringyesPreferred. Bearer <api_key>
X-Api-KeystringnoAlternate header if Bearer isn’t available
If missing/invalid, returns 401 { "error": "Invalid API key" }. Scopes Optional scopes restrict capabilities (if a key has none, send is allowed for backward compatibility):
ScopeRequired forNotes
send_emailPOST /api/v1/emails/*Required for both send and send-global
read_sendsGET /api/v1/sends/{id}Needed when you include a key
preferences_readGET /api/v1/preferencesWhen using an API key
preferences_managePOST /api/v1/preferencesWhen using an API key
Grant only the scopes your use case needs. See also: Scopes, Errors. Request IDs
  • Clients may send X-Request-Id to correlate logs.
  • All responses include X-Request-Id (generated if not provided).