Módulo 0627 endpoints

Users `/users`

Endpoints marcados como Reseller requieren rol reseller o superior.

Endpoints

27 en total

GET/users/meUsuario

Datos del usuario autenticado

Ejemplo

curl -X GET "https://envios.arrobamail.com/v3/api/users/me" \
  -H "Authorization: Bearer $TOKEN"

Respuesta 200

{
  "id": 1234, "uname": "usuario", "email": "u@ejemplo.com",
  "nombre": "Juan", "apellido": "Pérez", "empresa": "Mi Empresa",
  "role": "user", "user_type": "pro", "parent_id": 100,
  "active": 1, "max_sends": 50000, "max_suscribers": 10000,
  "creditos": 45000, "reputation": 95, "lang": "es"
}

PUT/users/meUsuario

Actualizar perfil propio

Request body · application/json

Nombre	Tipo	Req.	Descripción
`nombre`	`string`	No	Nombre
`apellido`	`string`	No	Apellido
`email`	`string`	No	Email
`empresa`	`string`	No	Empresa
`telefono`	`string`	No	Teléfono
`lang`	`string`	No	"es" o "en"
`timezone`	`string`	No	Timezone (e.g. "America/Buenos_Aires")

Ejemplo

curl -X PUT "https://envios.arrobamail.com/v3/api/users/me" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "nombre": "...",
  "apellido": "...",
  "email": "...",
  "empresa": "...",
  "telefono": "...",
  "lang": "...",
  "timezone": "..."
}'

Respuesta 200

{ "success": true }

PUT/users/me/passwordUsuario

Cambiar contraseña

Invalida todas las sesiones activas en todos los dispositivos.

Request body · application/json

Nombre	Tipo	Req.	Descripción
`currentPassword`	`string`	Sí	Contraseña actual
`newPassword`	`string`	Sí	Nueva contraseña

Ejemplo

curl -X PUT "https://envios.arrobamail.com/v3/api/users/me/password" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "currentPassword": "...",
  "newPassword": "..."
}'

Respuesta 200

{ "success": true }

GET/users/me/aicreditsUsuario

Créditos de IA disponibles

Ejemplo

curl -X GET "https://envios.arrobamail.com/v3/api/users/me/aicredits" \
  -H "Authorization: Bearer $TOKEN"

Respuesta 200

{
  "canGenerate": true,
  "monthlyAvailable": 45, "dailyAvailable": 8,
  "maxMonthlyGenerations": 50, "maxDailyGenerations": 10,
  "monthlyUsed": 5, "dailyUsed": 2
}

GET/users/me/public-configUsuario

Configuración pública global para la UI

Expone valores seguros para frontend combinando config.json y om_config. Incluye rate limits de eventos y límites de envíos de prueba.

Ejemplo

curl -X GET "https://envios.arrobamail.com/v3/api/users/me/public-config" \
  -H "Authorization: Bearer $TOKEN"

Respuesta 200

{
  "eventRateLimits": {
    "user": { "minute": 60, "hour": 1000, "day": 10000 },
    "global": { "minute": 600, "hour": 10000, "day": 100000 }
  },
  "testSendLimits": {
    "hourly": 10,
    "daily": 50
  }
}

GET/users/me/brand-kitsUsuario

Listar Kits de marca propios

Devuelve solo los Kits de marca del usuario autenticado.

Ejemplo

curl -X GET "https://envios.arrobamail.com/v3/api/users/me/brand-kits" \
  -H "Authorization: Bearer $TOKEN"

Respuesta 200

{
  "list": [
    { "id": 7, "status": "active", "isDefault": true, "revision": 2, "brandName": "Acme" }
  ]
}

POST/users/me/brand-kits/analyze-urlUsuario

Analizar URL para Kit de marca

Solo HTTPS. Bloquea URLs acortadas, privadas, internas y redirects cross-host.

Request body · application/json

Nombre	Tipo	Req.	Descripción
`url`	`string`	Sí	URL HTTPS del sitio a analizar

Ejemplo

curl -X POST "https://envios.arrobamail.com/v3/api/users/me/brand-kits/analyze-url" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "..."
}'

Respuesta 200

{
  "draft": { "brandName": "Acme", "primaryColor": "#112233", "toneOfVoice": "Directo" },
  "creditCost": 3,
  "poolBalanceAfter": 100
}

Errores

Status	Code	Descripción
400	`url_https_required`	La URL debe usar HTTPS
400	`url_shortener_not_allowed`	Host en blacklist de shorteners
400	`url_private_host_not_allowed`	Host privado o interno
400	`url_private_ip_not_allowed`	IP privada, link-local o reservada
400	`url_cross_host_redirect_not_allowed`	Redirect a otro host
402	`insufficient_credits`	Créditos IA insuficientes
429	`daily_limit_reached`	Límite diario IA alcanzado
429	`monthly_limit_reached`	Límite mensual IA alcanzado
429	`rate_limit_exceeded`	Demasiados análisis seguidos
500	`internal_error`	Error interno no público

POST/users/me/brand-kits/analyze-campaignsUsuario

Analizar campañas anteriores para Kit de marca

Analiza hasta 5 campañas propias.

Request body · application/json

Nombre	Tipo	Req.	Descripción
`campaignIds`	`number[]`	Sí	IDs de campañas propias. Máximo 5.

Ejemplo

curl -X POST "https://envios.arrobamail.com/v3/api/users/me/brand-kits/analyze-campaigns" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "campaignIds": [0]
}'

Respuesta 200

{ "draft": { "brandName": "Acme", "ctaStyle": "Directo" } }

Errores

Status	Code	Descripción
400	`missing_campaigns`	Lista vacía o inválida
400	`too_many_campaigns`	Más de 5 campañas
404	`campaign_not_found`	Campaña inexistente o ajena al usuario
402	`insufficient_credits`	Créditos IA insuficientes
429	`daily_limit_reached`	Límite diario IA alcanzado
429	`monthly_limit_reached`	Límite mensual IA alcanzado
429	`rate_limit_exceeded`	Demasiados análisis seguidos
500	`internal_error`	Error interno no público

POST/users/me/brand-kitsUsuario

Crear Kit de marca

Crea un borrador editable.

Request body · application/json

Nombre	Tipo	Req.	Descripción
`name`	`string`	No	Nombre interno del kit
`brandName`	`string`	No	Nombre de marca
`primaryColor`	`string`	No	Color hexadecimal #RRGGBB
`toneOfVoice`	`string`	No	Tono de voz

Ejemplo

curl -X POST "https://envios.arrobamail.com/v3/api/users/me/brand-kits" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "...",
  "brandName": "...",
  "primaryColor": "...",
  "toneOfVoice": "..."
}'

Respuesta 201

{ "kit": { "id": 7, "status": "draft", "revision": 1 } }

Errores

Status	Code	Descripción
400	`invalid_brand_kit_color`	Color inválido
400	`invalid_text_density`	Densidad de texto inválida
500	`brand_kit_create_failed`	No se pudo crear el registro
500	`internal_error`	Error interno no público
503	`brand_kits_not_configured`	Falta aplicar la migración de base de datos

PATCH/users/me/brand-kits/:idUsuario

Actualizar Kit de marca

Solo permite actualizar kits propios. Incrementa revision.

Parámetros de ruta

Nombre	Descripción
`id`	ID numérico del kit

Request body · application/json

Nombre	Tipo	Req.	Descripción
`brandName`	`string`	No	Nombre de marca
`visualStyle`	`string`	No	Estilo visual

Ejemplo

curl -X PATCH "https://envios.arrobamail.com/v3/api/users/me/brand-kits/{ID}" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "brandName": "...",
  "visualStyle": "..."
}'

Respuesta 200

{ "kit": { "id": 7, "revision": 2 } }

Errores

Status	Code	Descripción
400	`invalid_brand_kit_color`	Color inválido
400	`invalid_text_density`	Densidad de texto inválida
404	`brand_kit_not_found`	No existe o no pertenece al usuario
500	`internal_error`	Error interno no público
503	`brand_kits_not_configured`	Falta aplicar la migración de base de datos

POST/users/me/brand-kits/:id/activateUsuario

Activar Kit de marca

Marca el kit como activo/default para futuras generaciones IA.

Parámetros de ruta

Nombre	Descripción
`id`	ID numérico del kit

Ejemplo

curl -X POST "https://envios.arrobamail.com/v3/api/users/me/brand-kits/{ID}/activate" \
  -H "Authorization: Bearer $TOKEN"

Respuesta 200

{ "kit": { "id": 7, "status": "active", "isDefault": true } }

Errores

Status	Code	Descripción
404	`brand_kit_not_found`	No existe o no pertenece al usuario
500	`internal_error`	Error interno no público
503	`brand_kits_not_configured`	Falta aplicar la migración de base de datos

GET/users/:idReseller

Datos de un usuario específico

Parámetros de ruta

Nombre	Descripción
`id`	ID numérico del usuario

Ejemplo

curl -X GET "https://envios.arrobamail.com/v3/api/users/{ID}" \
  -H "Authorization: Bearer $TOKEN"

GET/users/:id/listReseller

Listar sub-usuarios

Parámetros de ruta

Nombre	Descripción
`id`	ID del reseller padre

Query params

Nombre	Tipo	Req.	Default	Descripción
`offset`	`number`	No	`0`	Desplazamiento
`limit`	`number`	No	`25`	Items por página
`userType`	`string`	No	`-`	Filtro por tipo de usuario
`searchString`	`string`	No	`-`	Búsqueda por email/username
`sortBy`	`string`	No	`-`	Campo de ordenamiento
`sortDesc`	`boolean`	No	`false`	Orden descendente

Ejemplo

curl -X GET "https://envios.arrobamail.com/v3/api/users/{ID}/list" \
  -H "Authorization: Bearer $TOKEN"

POST/users/:idReseller

Crear sub-usuario

Parámetros de ruta

Nombre	Descripción
`id`	ID del reseller padre

Request body · application/json

Nombre	Tipo	Req.	Descripción
`uname`	`string`	Sí	Username
`pass`	`string`	Sí	Contraseña
`email`	`string`	Sí	Email
`max_sends`	`number`	No	Límite de envíos por mes
`max_suscribers`	`number`	No	Límite de suscriptores
`creditos`	`number`	No	Créditos iniciales

Ejemplo

curl -X POST "https://envios.arrobamail.com/v3/api/users/{ID}" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "uname": "...",
  "pass": "...",
  "email": "...",
  "max_sends": 0,
  "max_suscribers": 0,
  "creditos": 0
}'

PUT/users/:idReseller

Actualizar sub-usuario

Parámetros de ruta

Nombre	Descripción
`id`	ID del usuario a actualizar

Request body · application/json

Nombre	Tipo	Req.	Descripción
`max_sends`	`number`	No	Límite de envíos
`max_suscribers`	`number`	No	Límite de suscriptores
`active`	`number`	No	1 = activo, 0 = inactivo

Ejemplo

curl -X PUT "https://envios.arrobamail.com/v3/api/users/{ID}" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "max_sends": 0,
  "max_suscribers": 0,
  "active": 0
}'

Respuesta 200

{ "success": true }

PUT/users/:id/creditsReseller

Actualizar créditos de un usuario

Parámetros de ruta

Nombre	Descripción
`id`	ID del usuario

Request body · application/json

Nombre	Tipo	Req.	Descripción
`amount`	`number`	Sí	Cantidad de créditos a asignar

Ejemplo

curl -X PUT "https://envios.arrobamail.com/v3/api/users/{ID}/credits" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "amount": 0
}'

Respuesta 200

{ "success": true }

GET/users/me/filesUsuario

Listar archivos y carpetas

Query params

Nombre	Tipo	Req.	Default	Descripción
`folder`	`string`	No	`/`	Ruta de carpeta a listar

Ejemplo

curl -X GET "https://envios.arrobamail.com/v3/api/users/me/files" \
  -H "Authorization: Bearer $TOKEN"

POST/users/me/filesUsuario

Subir archivo

Content-Type: multipart/form-data. Validación de imagen con Sharp.

Request body · multipart/form-data

Nombre	Tipo	Req.	Descripción
`file`	`file`	Sí	Archivo de imagen
`folder`	`string`	No	Carpeta destino (default: "/")

Ejemplo

curl -X POST "https://envios.arrobamail.com/v3/api/users/me/files" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "file": "<archivo>",
  "folder": "..."
}'

DELETE/users/me/filesUsuario

Eliminar archivo o carpeta

Request body · application/json

Nombre	Tipo	Req.	Descripción
`filePath`	`string`	Sí	Ruta del archivo o carpeta

Ejemplo

curl -X DELETE "https://envios.arrobamail.com/v3/api/users/me/files" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "filePath": "..."
}'

Respuesta 200

{ "success": true }

POST/users/me/files/folderUsuario

Crear carpeta

Request body · application/json

Nombre	Tipo	Req.	Descripción
`folderName`	`string`	Sí	Nombre alfanumérico de la carpeta
`folder`	`string`	No	Ruta base (default: "/")

Ejemplo

curl -X POST "https://envios.arrobamail.com/v3/api/users/me/files/folder" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "folderName": "...",
  "folder": "..."
}'

PUT/users/me/files/renameUsuario

Renombrar archivo o carpeta

Request body · application/json

Nombre	Tipo	Req.	Descripción
`filePath`	`string`	Sí	Ruta actual del archivo/carpeta
`newName`	`string`	Sí	Nuevo nombre

Ejemplo

curl -X PUT "https://envios.arrobamail.com/v3/api/users/me/files/rename" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "filePath": "...",
  "newName": "..."
}'

Respuesta 200

{ "success": true }

GET/users/me/ipsReseller

Listar IPs asignadas

Ejemplo

curl -X GET "https://envios.arrobamail.com/v3/api/users/me/ips" \
  -H "Authorization: Bearer $TOKEN"

GET/users/me/ips/:ipReseller

Estado y configuración de una IP

Parámetros de ruta

Nombre	Descripción
`ip`	Dirección IP (e.g. 192.168.1.1)

Ejemplo

curl -X GET "https://envios.arrobamail.com/v3/api/users/me/ips/{IP}" \
  -H "Authorization: Bearer $TOKEN"

PUT/users/me/ips/:ip/hostnameReseller

Actualizar hostname de IP

Parámetros de ruta

Nombre	Descripción
`ip`	Dirección IP

Request body · application/json

Nombre	Tipo	Req.	Descripción
`hostname`	`string`	Sí	Nuevo hostname

Ejemplo

curl -X PUT "https://envios.arrobamail.com/v3/api/users/me/ips/{IP}/hostname" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "hostname": "..."
}'

Respuesta 200

{ "success": true }

PUT/users/me/smtps/:smtpId/ownerReseller

Cambiar propietario de SMTP

Parámetros de ruta

Nombre	Descripción
`smtpId`	ID del servidor SMTP

Request body · application/json

Nombre	Tipo	Req.	Descripción
`userId`	`number`	Sí	ID del nuevo propietario

Ejemplo

curl -X PUT "https://envios.arrobamail.com/v3/api/users/me/smtps/{SMTPID}/owner" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "userId": 0
}'

Respuesta 200

{ "success": true }

PUT/users/me/smtps/:smtpId/activateReseller

Activar o desactivar SMTP

Parámetros de ruta

Nombre	Descripción
`smtpId`	ID del servidor SMTP

Request body · application/json

Nombre	Tipo	Req.	Descripción
`active`	`boolean`	Sí	true para activar, false para desactivar

Ejemplo

curl -X PUT "https://envios.arrobamail.com/v3/api/users/me/smtps/{SMTPID}/activate" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "active": true
}'

Respuesta 200

{ "success": true }

GET/users/:id/sendersReseller

Remitentes de un usuario

Parámetros de ruta

Nombre	Descripción
`id`	ID del usuario

Ejemplo

curl -X GET "https://envios.arrobamail.com/v3/api/users/{ID}/senders" \
  -H "Authorization: Bearer $TOKEN"

Empezá con arrobaMail
en menos de 5 minutos.

Plan Gratuito, generaciones de IA incluidas, sin tarjeta de crédito y soporte real en español.

Probar gratis ahora

Users /users

Datos del usuario autenticado

Actualizar perfil propio

Cambiar contraseña

Créditos de IA disponibles

Configuración pública global para la UI

Listar Kits de marca propios

Analizar URL para Kit de marca

Analizar campañas anteriores para Kit de marca

Crear Kit de marca

Actualizar Kit de marca

Activar Kit de marca

Datos de un usuario específico

Listar sub-usuarios

Crear sub-usuario

Actualizar sub-usuario

Actualizar créditos de un usuario

Listar archivos y carpetas

Subir archivo

Eliminar archivo o carpeta

Crear carpeta

Renombrar archivo o carpeta

Listar IPs asignadas

Estado y configuración de una IP

Actualizar hostname de IP

Cambiar propietario de SMTP

Activar o desactivar SMTP

Remitentes de un usuario

Empezá con arrobaMailen menos de 5 minutos.

Users `/users`

Empezá con arrobaMail
en menos de 5 minutos.