Módulo 123 endpoints

Subscription `/subscription`

Sin autenticación. Endpoints públicos para autoservicio de suscriptores.

Endpoints

3 en total

GET/subscription/:xsidPúblico

Obtener datos del suscriptor

No retorna campos internos (internal=true).

Parámetros de ruta

Nombre	Descripción
`xsid`	ID codificado del suscriptor (formato sid-lid-mid). Patrón: [qwertyuiops]{7,40}

Ejemplo

curl -X GET "https://envios.arrobamail.com/v3/api/subscription/{XSID}"

Respuesta 200

{
  "email": "user@example.com",
  "nombre": "Juan",
  "listData": { "name": "Newsletter", "description": "..." },
  "customFields": [
    { "id": 15, "name": "Ciudad", "value": "Buenos Aires", "type": "text" }
  ]
}

Errores

Status	Code	Descripción
404	`not_found`	Suscriptor no encontrado
410	`unsubscribed`	Suscriptor ya desuscripto

PUT/subscription/:xsidPúblico

Actualizar datos del suscriptor

Campos date requieren Unix timestamp. Dropdown/radio deben coincidir con opciones. Campos internos se ignoran.

Parámetros de ruta

Nombre	Descripción
`xsid`	ID codificado del suscriptor

Request body · application/json

Nombre	Tipo	Req.	Descripción
`nombre`	`string`	No	Nuevo nombre
`customFields`	`object`	No	{ "fieldId": "value" }

Ejemplo

curl -X PUT "https://envios.arrobamail.com/v3/api/subscription/{XSID}" \
  -H "Content-Type: application/json" \
  -d '{
  "nombre": "...",
  "customFields": {}
}'

Respuesta 200

{ "success": true }

DELETE/subscription/:xsidPúblico

Desuscribirse

Parámetros de ruta

Nombre	Descripción
`xsid`	ID codificado del suscriptor

Query params

Nombre	Tipo	Req.	Default	Descripción
`spam`	`string`	No	`-`	"1" para registrar como queja de spam

Ejemplo

curl -X DELETE "https://envios.arrobamail.com/v3/api/subscription/{XSID}"

Respuesta 200

{ "success": true }

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

Subscription /subscription

Obtener datos del suscriptor

Actualizar datos del suscriptor

Desuscribirse

Empezá con arrobaMailen menos de 5 minutos.

Subscription `/subscription`

Empezá con arrobaMail
en menos de 5 minutos.