Module 123 endpoints

Subscription `/subscription`

No authentication. Public endpoints for subscriber self-service.

Endpoints

3 total

GET/subscription/:xsidPublic

Get subscriber data

Does not return internal fields (internal=true).

Path parameters

Name	Description
`xsid`	Encoded subscriber ID (sid-lid-mid format). Pattern: [qwertyuiops]{7,40}

Example

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

Response 200

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

Errors

Status	Code	Description
404	`not_found`	Subscriber not found
410	`unsubscribed`	Subscriber already unsubscribed

PUT/subscription/:xsidPublic

Update subscriber data

Date fields require a Unix timestamp. Dropdown/radio must match the available options. Internal fields are ignored.

Path parameters

Name	Description
`xsid`	Encoded subscriber ID

Request body · application/json

Name	Type	Req.	Description
`nombre`	`string`	No	New name
`customFields`	`object`	No	{ "fieldId": "value" }

Example

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

Response 200

{ "success": true }

DELETE/subscription/:xsidPublic

Unsubscribe

Path parameters

Name	Description
`xsid`	Encoded subscriber ID

Query params

Name	Type	Req.	Default	Description
`spam`	`string`	No	`-`	"1" to register as a spam complaint

Example

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

Response 200

{ "success": true }

Get started with arrobaMail
in under 5 minutes.

Free plan, AI generations included, no credit card required — and real support from a real team.

Try it free now

Subscription /subscription

Get subscriber data

Update subscriber data

Unsubscribe

Get started with arrobaMailin under 5 minutes.

Subscription `/subscription`

Get started with arrobaMail
in under 5 minutes.