Adapty Mail API

v1.0.0
Download OpenAPI spec

The Adapty Mail API lets you send user profiles and transaction events to Adapty Mail directly from your server, without routing the data through the Adapty SDK.

Use it to:

  • Add subscribers when you don't have a base in Adapty Mail yet.
  • Reuse the subscriber base from your other apps.
  • Feed Adapty Mail server-to-server, with your backend as the source of truth.

A profile with an email is enough for the never purchased flow. Every other flow (renewal cancelled, billing issue, expired, refunded) is driven by purchase history, so those profiles also need transaction events to be placed in the right flow.

For a step-by-step walkthrough, see Send emails and transactions via the Adapty Mail API.

Servers

  • https://api-mail.adapty.io — Production server

Authentication

Authorization

Type: apiKey · In: header

Authenticate every request with your Adapty Mail secret API key, sent as the Authorization header with the value Bearer {your_secret_api_key}, for example, Bearer secret_live_....

Find this key in Adapty Mail under Settings. The key is project-specific — it identifies the project the data belongs to, so the profile and transaction endpoints don't take a project ID.

curl --request GET \
  --url 'https://api-mail.adapty.io/...' \
  --header 'Authorization: Bearer YOUR_ADAPTY_MAIL_SECRET_API_KEY'

Operations