Envoyer des e-mails et des transactions via l'API Adapty Mail

L’API Adapty Mail vous permet d’envoyer des profils utilisateurs et des transactions à Adapty Mail directement depuis votre serveur, sans passer par le SDK Adapty. Utilisez-la quand vous souhaitez :

• Ajouter des abonnés si vous n’avez pas encore de base dans Adapty Mail.
• Réutiliser la base d’abonnés de vos autres applications.
• Alimenter Adapty Mail en serveur à serveur, avec votre backend comme source de vérité.

Avant de commencer

Vous avez également besoin de votre clé API et de l’URL de base :

• Clé API secrète : dans Adapty Mail, rendez-vous dans Settings et copiez votre clé API secrète. La clé est spécifique au projet, ce qui permet à l’API de savoir à quel projet appartiennent les données.
• URL de base : toutes les requêtes sont adressées à https://api-mail.adapty.io.
• Authentification : envoyez la clé dans l’en-tête Authorization sous la forme Bearer {your_secret_api_key}.

Envoyer des profils utilisateurs

Un profil contient l’adresse e-mail de l’utilisateur et ses attributs. Pour en créer ou en mettre à jour un, envoyez une requête POST à /api/v1/profile/save/.

Trois champs sont obligatoires :

• Un external_profile_id stable, propre à votre application ou à votre backend
• L’email auquel Adapty Mail envoie les campagnes
• external_created_at — la date de création de l’utilisateur, utilisable dans les segments

curl --request POST \
  --url 'https://api-mail.adapty.io/api/v1/profile/save/' \
  --header 'Authorization: Bearer {your_secret_api_key}' \
  --header 'Content-Type: application/json' \
  --data '{
    "external_profile_id": "user_12345",
    "external_created_at": "2026-06-01T10:30:00Z",
    "email": "jane@example.com",
    "country": "US",
    "custom_attributes": {
      "plan": "trial"
    }
  }'

Consultez la référence Save profile pour la liste complète des champs disponibles.

Envoyer des événements de transaction

Tous les flows, sauf never purchased, reposent sur l’historique d’achats. Envoyez les événements de transaction d’un profil au fur et à mesure que vous gérez les achats, les renouvellements et les annulations, afin qu’Adapty Mail puisse le placer dans le bon flow. Les événements de transaction alimentent également l’attribution des revenus. Ne les envoyez pas uniquement si vous gérez exclusivement des campagnes never purchased.

Pour enregistrer une transaction, envoyez une requête POST à /api/v1/profile/transaction-event/save/. Utilisez le même external_profile_id que celui envoyé avec le profil afin qu’Adapty Mail associe la transaction au bon utilisateur.

curl --request POST \
  --url 'https://api-mail.adapty.io/api/v1/profile/transaction-event/save/' \
  --header 'Authorization: Bearer {your_secret_api_key}' \
  --header 'Content-Type: application/json' \
  --data '{
    "event_type": "subscription_started",
    "event_id": "evt_abc123",
    "event_datetime": "2026-06-10T14:20:05Z",
    "external_profile_id": "user_12345",
    "store": "app_store",
    "store_product_id": "premium_monthly",
    "store_transaction_id": "1000000123456789",
    "store_original_transaction_id": "1000000123456789",
    "purchased_at": "2026-06-10T14:20:00Z",
    "originally_purchased_at": "2026-06-10T14:20:00Z",
    "price_usd": "9.99"
  }'

Consultez la référence Save transaction event pour la liste complète des champs disponibles.

Associer vos événements aux flows

Envoyez l’event_type correspondant à ce qui s’est passé. Adapty Mail déduit l’état du profil à partir de son historique d’événements et le dirige vers le flow correspondant.