Skip to content

Mailing Lists

All operations require authentication, except the one marked Public.

16 operationsv1/email/domain
Agent setup

Get mailing list limitsProductionPublic

GET
/1.0/email/domain/mailingListLimits

Get mailing list limits. Returns the maximum number of subscribers of a mailing list, with or without message moderation (moderatorMessage).

Query parameters

moderatorMessage
required
boolean

If true, messages are moderate

Response

200DomainMlLimitssuccessful operation
subscribers
integer

Maximum number of subscribers

Public: no token needed

$ curl https://api.eu.ovhcloud.com/1.0/email/domain/mailingListLimits
ResponseExample
{ "subscribers": 0}

List mailing listsProduction

GET
/1.0/email/domain/{domain}/mailingList

List mailing lists. Returns the names of the mailing lists of the domain. Filter them by name to look for a given list.

Path parameters

domain
required
string

Name of your domain name

Query parameters

name
string

Mailing list name

Response

200string[]successful operation

Example uses domain = string

$ curl https://api.eu.ovhcloud.com/1.0/email/domain/{domain}/mailingList \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
[ "string"]

Get a mailing listProduction

GET
/1.0/email/domain/{domain}/mailingList/{name}

Get a mailing list. Returns the owner email, reply-to address, language, moderation options and number of subscribers of the mailing list.

Path parameters

domain
required
string

Name of your domain name

name
required
string

Name of mailing list

Response

200MailingListsuccessful operation
id
read-only
integer

Id of mailing list

language
DomainMlLanguageEnum

Language of mailing list

Valuesdeenesfritnlplpt
name
read-only
string

Name of mailing list

nbSubscribers
read-only
integer

Subscribers number of mailing list

nbSubscribersUpdateDate
read-only
stringdate-time

Last update subscribers

options
read-only
DomainMlOptionsStruct

Options of mailing list

ownerEmail
string

Owner email of mailing list

replyTo
string

Email to reply of mailing list

Example uses domain = string, name = string

$ curl https://api.eu.ovhcloud.com/1.0/email/domain/{domain}/mailingList/{name} \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "id": 0, "language": "de", "name": "string", "nbSubscribers": 0, "nbSubscribersUpdateDate": "2024-01-01T12:00:00Z", "options": { "moderatorMessage": true, "subscribeByModerator": true, "usersPostOnly": true }, "ownerEmail": "string", "replyTo": "string"}

Create a mailing listProduction

POST
/1.0/email/domain/{domain}/mailingList

Create a mailing list. Creates a mailing list with a name, an owner email, a language and moderation options, and returns the task.

Path parameters

domain
required
string

Name of your domain name

Request body (required)

language
required
DomainMlLanguageEnum

Language of mailing list

Valuesdeenesfritnlplpt
name
required
string

Mailing list name

options
required
DomainMlOptionsStruct

Options of mailing list

ownerEmail
required
string

Owner Email

replyTo
string

Email to reply of mailing list

Response

200TaskMlsuccessful operation
account
read-only
string
—
action
read-only
string
—
date
read-only
stringdate-time
—
domain
read-only
string
—
id
read-only
integer
—
language
read-only
DomainMlLanguageEnum

Possible values for mailing list language

Valuesdeenesfritnlplpt

Example uses domain = string

$ curl https://api.eu.ovhcloud.com/1.0/email/domain/{domain}/mailingList \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "account": "string", "action": "string", "date": "2024-01-01T12:00:00Z", "domain": "string", "id": 0, "language": "de"}

Delete a mailing listProduction

DELETE
/1.0/email/domain/{domain}/mailingList/{name}

Delete a mailing list. Deletes the mailing list of the domain with its subscribers and moderators, and returns the task.

Path parameters

domain
required
string

Name of your domain name

name
required
string

Name of mailing list

Response

200TaskMlsuccessful operation
account
read-only
string
—
action
read-only
string
—
date
read-only
stringdate-time
—
domain
read-only
string
—
id
read-only
integer
—
language
read-only
DomainMlLanguageEnum

Possible values for mailing list language

Valuesdeenesfritnlplpt

Example uses domain = string, name = string

$ curl https://api.eu.ovhcloud.com/1.0/email/domain/{domain}/mailingList/{name} \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "account": "string", "action": "string", "date": "2024-01-01T12:00:00Z", "domain": "string", "id": 0, "language": "de"}

Update a mailing listProduction

PUT
/1.0/email/domain/{domain}/mailingList/{name}

Update a mailing list. Updates the owner email, the reply-to address or the language of the mailing list.

Path parameters

domain
required
string

Name of your domain name

name
required
string

Name of mailing list

Request body (required)

id
read-only
integer

Id of mailing list

language
DomainMlLanguageEnum

Language of mailing list

Valuesdeenesfritnlplpt
name
read-only
string

Name of mailing list

nbSubscribers
read-only
integer

Subscribers number of mailing list

nbSubscribersUpdateDate
read-only
stringdate-time

Last update subscribers

options
read-only
DomainMlOptionsStruct

Options of mailing list

ownerEmail
string

Owner email of mailing list

replyTo
string

Email to reply of mailing list

Response

200—successful operation

Example uses domain = string, name = string

$ curl https://api.eu.ovhcloud.com/1.0/email/domain/{domain}/mailingList/{name} \
  -H "authorization: Bearer $OVH_TOKEN"

Change mailing list optionsProduction

POST
/1.0/email/domain/{domain}/mailingList/{name}/changeOptions

Change mailing list options. Sets message moderation (moderatorMessage), subscription moderation (subscribeByModerator) and usersPostOnly, which lets only moderators post, and returns the task.

Path parameters

domain
required
string

Name of your domain name

name
required
string

Name of mailing list

Request body (required)

options
required
DomainMlOptionsStruct

Options of mailing list

Response

200TaskMlsuccessful operation
account
read-only
string
—
action
read-only
string
—
date
read-only
stringdate-time
—
domain
read-only
string
—
id
read-only
integer
—
language
read-only
DomainMlLanguageEnum

Possible values for mailing list language

Valuesdeenesfritnlplpt

Example uses domain = string, name = string

$ curl https://api.eu.ovhcloud.com/1.0/email/domain/{domain}/mailingList/{name}/changeOptions \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "account": "string", "action": "string", "date": "2024-01-01T12:00:00Z", "domain": "string", "id": 0, "language": "de"}

List moderatorsProduction

GET
/1.0/email/domain/{domain}/mailingList/{name}/moderator

List moderators. Returns the email addresses of the moderators of the mailing list. Filter them by email.

Path parameters

domain
required
string

Name of your domain name

name
required
string

Name of mailing list

Query parameters

email
string

Moderator email

Response

200string[]successful operation

Example uses domain = string, name = string

$ curl https://api.eu.ovhcloud.com/1.0/email/domain/{domain}/mailingList/{name}/moderator \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
[ "string"]

Get a moderatorProduction

GET
/1.0/email/domain/{domain}/mailingList/{name}/moderator/{email}

Get a moderator. Returns the email address of the moderator and the mailing list and domain it moderates.

Path parameters

domain
required
string

Name of your domain name

email
required
string
—
name
required
string

Name of mailing list

Response

200Moderatorsuccessful operation
domain
read-only
string
—
email
read-only
string
—
mailinglist
read-only
string
—

Example uses domain = string, email = string, name = string

$ curl https://api.eu.ovhcloud.com/1.0/email/domain/{domain}/mailingList/{name}/moderator/{email} \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "domain": "string", "email": "string", "mailinglist": "string"}

Add a moderatorProduction

POST
/1.0/email/domain/{domain}/mailingList/{name}/moderator

Add a moderator. Makes the email address a moderator of the mailing list, who approves the messages, and returns the task.

Path parameters

domain
required
string

Name of your domain name

name
required
string

Name of mailing list

Request body (required)

email
required
string

Email of moderator

Response

200TaskMlsuccessful operation
account
read-only
string
—
action
read-only
string
—
date
read-only
stringdate-time
—
domain
read-only
string
—
id
read-only
integer
—
language
read-only
DomainMlLanguageEnum

Possible values for mailing list language

Valuesdeenesfritnlplpt

Example uses domain = string, name = string

$ curl https://api.eu.ovhcloud.com/1.0/email/domain/{domain}/mailingList/{name}/moderator \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "account": "string", "action": "string", "date": "2024-01-01T12:00:00Z", "domain": "string", "id": 0, "language": "de"}

Remove a moderatorProduction

DELETE
/1.0/email/domain/{domain}/mailingList/{name}/moderator/{email}

Remove a moderator. Withdraws the moderator role from the email address on the mailing list, and returns the task.

Path parameters

domain
required
string

Name of your domain name

email
required
string
—
name
required
string

Name of mailing list

Response

200TaskMlsuccessful operation
account
read-only
string
—
action
read-only
string
—
date
read-only
stringdate-time
—
domain
read-only
string
—
id
read-only
integer
—
language
read-only
DomainMlLanguageEnum

Possible values for mailing list language

Valuesdeenesfritnlplpt

Example uses domain = string, email = string, name = string

$ curl https://api.eu.ovhcloud.com/1.0/email/domain/{domain}/mailingList/{name}/moderator/{email} \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "account": "string", "action": "string", "date": "2024-01-01T12:00:00Z", "domain": "string", "id": 0, "language": "de"}

Send member lists by emailProduction

POST
/1.0/email/domain/{domain}/mailingList/{name}/sendListByEmail

Send member lists by email. Sends the lists of moderators and subscribers of the mailing list to the email address, and returns the task.

Path parameters

domain
required
string

Name of your domain name

name
required
string

Name of mailing list

Request body (required)

email
required
string

Email destination

Response

200TaskMlsuccessful operation
account
read-only
string
—
action
read-only
string
—
date
read-only
stringdate-time
—
domain
read-only
string
—
id
read-only
integer
—
language
read-only
DomainMlLanguageEnum

Possible values for mailing list language

Valuesdeenesfritnlplpt

Example uses domain = string, name = string

$ curl https://api.eu.ovhcloud.com/1.0/email/domain/{domain}/mailingList/{name}/sendListByEmail \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "account": "string", "action": "string", "date": "2024-01-01T12:00:00Z", "domain": "string", "id": 0, "language": "de"}

List subscribersProduction

GET
/1.0/email/domain/{domain}/mailingList/{name}/subscriber

List subscribers. Returns the email addresses of the subscribers of the mailing list. Filter them by email.

Path parameters

domain
required
string

Name of your domain name

name
required
string

Name of mailing list

Query parameters

email
string

Subscriber email

Response

200string[]successful operation

Example uses domain = string, name = string

$ curl https://api.eu.ovhcloud.com/1.0/email/domain/{domain}/mailingList/{name}/subscriber \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
[ "string"]

Get a subscriberProduction

GET
/1.0/email/domain/{domain}/mailingList/{name}/subscriber/{email}

Get a subscriber. Returns the email address of the subscriber and the mailing list and domain it is subscribed to.

Path parameters

domain
required
string

Name of your domain name

email
required
string
—
name
required
string

Name of mailing list

Response

200Subscribersuccessful operation
domain
read-only
string
—
email
read-only
string
—
mailinglist
read-only
string
—

Example uses domain = string, email = string, name = string

$ curl https://api.eu.ovhcloud.com/1.0/email/domain/{domain}/mailingList/{name}/subscriber/{email} \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "domain": "string", "email": "string", "mailinglist": "string"}

Add a subscriberProduction

POST
/1.0/email/domain/{domain}/mailingList/{name}/subscriber

Add a subscriber. Subscribes the email address to the mailing list, so that it receives its messages, and returns the task.

Path parameters

domain
required
string

Name of your domain name

name
required
string

Name of mailing list

Request body (required)

email
required
string

Email of subscriber

Response

200TaskMlsuccessful operation
account
read-only
string
—
action
read-only
string
—
date
read-only
stringdate-time
—
domain
read-only
string
—
id
read-only
integer
—
language
read-only
DomainMlLanguageEnum

Possible values for mailing list language

Valuesdeenesfritnlplpt

Example uses domain = string, name = string

$ curl https://api.eu.ovhcloud.com/1.0/email/domain/{domain}/mailingList/{name}/subscriber \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "account": "string", "action": "string", "date": "2024-01-01T12:00:00Z", "domain": "string", "id": 0, "language": "de"}

Remove a subscriberProduction

DELETE
/1.0/email/domain/{domain}/mailingList/{name}/subscriber/{email}

Remove a subscriber. Unsubscribes the email address from the mailing list, which it no longer receives, and returns the task.

Path parameters

domain
required
string

Name of your domain name

email
required
string
—
name
required
string

Name of mailing list

Response

200TaskMlsuccessful operation
account
read-only
string
—
action
read-only
string
—
date
read-only
stringdate-time
—
domain
read-only
string
—
id
read-only
integer
—
language
read-only
DomainMlLanguageEnum

Possible values for mailing list language

Valuesdeenesfritnlplpt

Example uses domain = string, email = string, name = string

$ curl https://api.eu.ovhcloud.com/1.0/email/domain/{domain}/mailingList/{name}/subscriber/{email} \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "account": "string", "action": "string", "date": "2024-01-01T12:00:00Z", "domain": "string", "id": 0, "language": "de"}