POST mailinglists
BearerAuthorizationBearer <token>Paste your JWT token here
The DTO containing the provider list to curate and its visibility.
application/json- body
Defines the DTO for curating a new mailing list.
providerListId*stringThe mail subscription provider's identifier for the list to curate (e.g. a Mailchimp interest ID).
visibility*MailinglistVisibilityControls where a curated mailing list is shown to members. General lists appear everywhere (registration, account settings, the yearly renewal page); YearlyRenewalOnly lists appear only on the yearly study-renewal page, alongside the General lists.
int32"General""YearlyRenewalOnly"Created
application/json- response
Represents a curated mailing list together with its live-resolved display name and whether the underlying provider list still exists.
id?integerThe curation record's own identifier.
int32providerListId?stringThe mail subscription provider's identifier for the list.
name?|The list's current display name at the provider, or null if it's orphaned.
visibility?MailinglistVisibilityControls where a curated mailing list is shown to members. General lists appear everywhere (registration, account settings, the yearly renewal page); YearlyRenewalOnly lists appear only on the yearly study-renewal page, alongside the General lists.
int32"General""YearlyRenewalOnly"orphaned?booleanWhether the curated provider list no longer exists at the provider.
curl -X POST 'https://example.com/mailinglists' \ -H 'Content-Type: application/json' \ -d '{ "providerListId": "string", "visibility": "General"}'{ "id": 0, "providerListId": "string", "name": "string", "visibility": "General", "orphaned": true}