Subscribe by mailinglist id

Developing

POST

/reader-hub/v2/mailinglists/{mailinglist_id}/subscriptions

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Path Params

Body Params application/json

Examples

Responses

🟢201Success

application/json

Bodyapplication/json

🟠400Invalid UUID

🟠401Unauthorized API KEY

🟠403Unauthorized roles

🟠404Entity not found

🟠409Conflict

🟠422Unprocessable Entity

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://prod.your-api-server.com/reader-hub/v2/mailinglists/c0a550d2-1bc6-4011-8f5a-cc42212dd1da/subscriptions' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "subscribers": [
        {
            "email": "alice@example.com",
            "name": "Alice"
        }
    ]
}'

Response Example

201 - Success

{
    "data": {
      "id": "uuid (subscription_id)",
      "reader_id": "uuid"
    }
  }

Modified at 2026-05-22 08:02:01

Paginated subscriptions by mailinglist id

Event Invitation Created