/api/v1/profile/save/ Guardar perfil
Crea o actualiza un perfil en Adapty Mail. Un perfil incluye el email del usuario y atributos que Adapty Mail utiliza para identificar destinatarios y construir segmentos.
Identifica a cada usuario con un external_profile_id estable. Enviar el mismo external_profile_id
de nuevo actualiza el perfil existente en lugar de crear un duplicado.
Request body
Identificador estable del usuario, gestionado por tu aplicación o backend. Reutiliza el mismo valor en las solicitudes para que Adapty Mail vincule emails, clics y compras a un único perfil. Nunca uses un identificador anónimo o por instalación.
La fecha y hora de creación del usuario, en formato ISO 8601 (por ejemplo, "2026-06-01T10:30:00Z").
Puedes usar esta fecha en los segmentos.
La dirección de email del usuario. Adapty Mail entrega las campañas a esta dirección.
El nombre del usuario.
Los apellidos del usuario.
El género del usuario.
La fecha de nacimiento del usuario, en formato ISO 8601 (por ejemplo, "1990-05-21").
El país del usuario como código ISO 3166-1 alpha-2 de dos letras en mayúsculas (por ejemplo, US).
La región del store del usuario como código ISO 3166-1 alpha-2 de dos letras en mayúsculas (por ejemplo, US).
Pares clave-valor arbitrarios (valores de cadena o numéricos) para adjuntar al perfil. Úsalos para
construir segmentos — por ejemplo, plan, signup_source o trial_days.
La plataforma en la que se encuentra el usuario, por ejemplo, iOS o Android.
Modelo del dispositivo, por ejemplo, iPhone15,2.
Versión del sistema operativo, por ejemplo, 17.5.
El locale del usuario, por ejemplo, en-US.
La zona horaria del usuario, por ejemplo, America/New_York.
Versión de tu aplicación que está ejecutando el usuario, por ejemplo, 3.1.0.
Responses
Perfil guardado correctamente. El cuerpo de la respuesta es un objeto vacío.
Schema
Example
{}Validación fallida — falta un campo obligatorio o es inválido. field_name indica qué campo.
Schema
Respuesta de error estándar. Cada fallo devuelve un estado 4XX con esta estructura.
Descripción legible del error.
Identificador del error legible por máquina.
Código de estado HTTP para este error.
El campo de la solicitud que provocó el error, o null si el error no está asociado a un campo específico.
Example
{
"errors": [
{
"message": "Field required",
"error_code": "base_error",
"status_code": 400,
"field_name": "email"
}
]
}Clave API secreta ausente o inválida.
Schema
Respuesta de error estándar. Cada fallo devuelve un estado 4XX con esta estructura.
Descripción legible del error.
Identificador del error legible por máquina.
Código de estado HTTP para este error.
El campo de la solicitud que provocó el error, o null si el error no está asociado a un campo específico.
Example
{
"errors": [
{
"message": "Secret key doesn't exist",
"error_code": "secret_key_does_not_exist_error",
"status_code": 403,
"field_name": null
}
]
}