listmonk unofficial
POST/public/subscription

Submit a public subscription request

Submits a subscription request through the public API. Include email and optionally name and list_uuids in the request body; the schema does not mark any fields as required. A 200 response indicates whether opt-in is required in has_optin.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

3 body fields

Optional subscription request parameters.

namestringoptional
The subscriber's name.
emailstringoptional
The subscriber's email address.
list_uuidsarray<string>optional
An array of list UUIDs associated with the subscription request.

1 status code
200Returns an object with `has_optin`, indicating whether opt-in is required.
has_optinbooleanoptional

Error handling

The request body is optional, and none of its fields are required. If supplied, name and email must be strings, and list_uuids must be an array of strings.