Enviar emails y transacciones a través de la API de Adapty Mail

La API de Adapty Mail te permite enviar perfiles de usuario y transacciones a Adapty Mail directamente desde tu servidor, sin enrutar los datos a través del SDK de Adapty. Úsala cuando quieras:

• Agrega suscriptores cuando aún no tienes una base en Adapty Mail.
• Reutiliza la base de suscriptores de tus otras apps.
• Alimenta Adapty Mail de servidor a servidor, con tu backend como fuente de verdad.

Antes de empezar

También necesitas tu clave API y la URL base:

• Clave API secreta: En Adapty Mail, ve a Settings y copia tu clave API secreta. La clave es específica del proyecto, de modo que la API sabe a qué proyecto pertenecen los datos.
• URL base: Todas las solicitudes van a https://api-mail.adapty.io.
• Autenticación: Envía la clave en el encabezado Authorization como Bearer {your_secret_api_key}.

Enviar perfiles de usuario

Un perfil contiene el email y los atributos del usuario. Para crear o actualizar uno, envía una solicitud POST a /api/v1/profile/save/.

Se requieren tres campos:

• Un external_profile_id estable que tu app o backend gestione
• El email al que Adapty Mail envía las campañas
• external_created_at — la fecha de creación del usuario, que puedes usar en segmentos

Si la misma persona también llega a Adapty Mail a través del SDK, añade customer_user_id — tu propio ID de usuario, el que pasas a Adapty.identify(). Adapty Mail lo usa para hacer la coincidencia y mantiene ambas fuentes en un único perfil, en lugar de crear un duplicado que envíe el correo dos veces a la misma persona.

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"
    }
  }'

Consulta la referencia de Save profile para ver todos los campos disponibles.

Enviar eventos de transacción

Todos los flows excepto el de nunca han comprado se basan en el historial de compras. Envía los eventos de transacción de un perfil a medida que gestiones compras, renovaciones y cancelaciones, para que Adapty Mail pueda ubicarlo en el flow correcto. Los eventos de transacción también alimentan la atribución de ingresos. Omítelos solo si ejecutas campañas exclusivamente de nunca han comprado. Para registrar una transacción, envía una petición POST a /api/v1/profile/transaction-event/save/. Usa el mismo external_profile_id que enviaste con el perfil para que Adapty Mail vincule la transacción al usuario correcto.

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"
  }'

See the Save transaction event reference for every available field.

You can send a transaction before the profile exists. Adapty Mail keeps the event unattached, then links it to the profile on the next save that includes the same external_profile_id.

Eliminar un perfil

Para atender una solicitud de derecho al olvido, envía los identificadores del perfil a /api/v1/profile/delete/. Adapty Mail borra los datos personales del perfil y cancela sus correos programados.

curl --request POST \
  --url 'https://api-mail.adapty.io/api/v1/profile/delete/' \
  --header 'Authorization: Bearer {your_secret_api_key}' \
  --header 'Content-Type: application/json' \
  --data '{
    "external_profile_id": "user_12345"
  }'

Identifica el perfil mediante external_profile_id, customer_user_id o email — envía al menos uno. El borrado es definitivo: guardar posteriormente los mismos identificadores no vuelve a crear el perfil.

Para que un reintento sea seguro, identifica el perfil mediante external_profile_id o customer_user_id. Repetir un borrado que solo incluía email devuelve 404, porque el borrado elimina la dirección almacenada. Consulta la referencia Eliminar perfil para más detalles.

Asigna tus eventos a los flows

Envía el event_type que corresponda a lo que ocurrió. Adapty Mail deduce el estado del perfil a partir del historial de eventos y lo enruta al flow correspondiente.