Skip to content

Aliases

All operations require authentication.

4 operationsv1/email/mxplan
Agent setup

List account aliasesProduction

GET
/1.0/email/mxplan/{service}/account/{email}/alias

List account aliases. Returns the aliases of the email account: extra addresses that deliver to the same mailbox.

Path parameters

email
required
string

Default email for this mailbox

service
required
string

The internal name of your mxplan organization

Response

200string[]successful operation

Example uses email = string, service = string

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

Get an account aliasProduction

GET
/1.0/email/mxplan/{service}/account/{email}/alias/{alias}

Get an account alias. Returns the alias address, its creation date and the ID of its pending task, if any (taskPendingId).

Path parameters

alias
required
string

Alias

email
required
string

Default email for this mailbox

service
required
string

The internal name of your mxplan organization

Response

200AccountAliassuccessful operation
alias
read-only
string

Alias

creationDate
read-only
stringdate-time

Creation date

taskPendingId
read-only
integer

Pending task id

Example uses alias = string, email = string, service = string

$ curl https://api.eu.ovhcloud.com/1.0/email/mxplan/{service}/account/{email}/alias/{alias} \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "alias": "string", "creationDate": "2024-01-01T12:00:00Z", "taskPendingId": 0}

Create an account aliasProduction

POST
/1.0/email/mxplan/{service}/account/{email}/alias

Create an account alias. Adds the alias address to the email account, so that it receives its emails, and returns the task.

Path parameters

email
required
string

Default email for this mailbox

service
required
string

The internal name of your mxplan organization

Request body (required)

alias
required
string

Alias

Response

200Tasksuccessful operation
finishDate
read-only
stringdate-time

Completion date

function
read-only
TaskFunctionEnum

Function name

ValuesaddAccountaddAliasaddDomainaddDomainDKIMaddDomainDisclaimeraddExternalContactaddFullAccessaddSendAsaddSendOnBehalfToaddServiceAuthorizedIpchangeHostnamechangePasswordconfigureCustomerdeleteAccountdeleteAliasdeleteDomaindeleteDomainDKIMdeleteDomainDisclaimerdeleteExternalContactdeleteFullAccessdeleteSendAsdeleteSendOnBehalfTodeleteServicedeleteServiceAuthorizedIpdiagnoseAccountdisableDKIMenableDKIMexpandDriveinstallServermaintenancemigrateAccountViaOMMmigrationAccountmigrationDisclaimermigrationExternalContactmigrationHistorymigrationServicereOpenAccountsetAccountsetAliassetDnssetDomainsetDomainDisclaimersetExternalContactsetServicesuspendAccountsuspendServiceunknownunsuspendAccountunsuspendService
id
read-only
integer

Task id

status
read-only
TaskStatusEnum

Task status

Valuescancelleddoingdoneerrortodo
todoDate
read-only
stringdate-time

Creation date

Example uses email = string, service = string

$ curl https://api.eu.ovhcloud.com/1.0/email/mxplan/{service}/account/{email}/alias \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "finishDate": "2024-01-01T12:00:00Z", "function": "addAccount", "id": 0, "status": "cancelled", "todoDate": "2024-01-01T12:00:00Z"}

Delete an account aliasProduction

DELETE
/1.0/email/mxplan/{service}/account/{email}/alias/{alias}

Delete an account alias. Removes the alias address from the email account, which no longer receives its emails, and returns the task.

Path parameters

alias
required
string

Alias

email
required
string

Default email for this mailbox

service
required
string

The internal name of your mxplan organization

Response

200Tasksuccessful operation
finishDate
read-only
stringdate-time

Completion date

function
read-only
TaskFunctionEnum

Function name

ValuesaddAccountaddAliasaddDomainaddDomainDKIMaddDomainDisclaimeraddExternalContactaddFullAccessaddSendAsaddSendOnBehalfToaddServiceAuthorizedIpchangeHostnamechangePasswordconfigureCustomerdeleteAccountdeleteAliasdeleteDomaindeleteDomainDKIMdeleteDomainDisclaimerdeleteExternalContactdeleteFullAccessdeleteSendAsdeleteSendOnBehalfTodeleteServicedeleteServiceAuthorizedIpdiagnoseAccountdisableDKIMenableDKIMexpandDriveinstallServermaintenancemigrateAccountViaOMMmigrationAccountmigrationDisclaimermigrationExternalContactmigrationHistorymigrationServicereOpenAccountsetAccountsetAliassetDnssetDomainsetDomainDisclaimersetExternalContactsetServicesuspendAccountsuspendServiceunknownunsuspendAccountunsuspendService
id
read-only
integer

Task id

status
read-only
TaskStatusEnum

Task status

Valuescancelleddoingdoneerrortodo
todoDate
read-only
stringdate-time

Creation date

Example uses alias = string, email = string, service = string

$ curl https://api.eu.ovhcloud.com/1.0/email/mxplan/{service}/account/{email}/alias/{alias} \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "finishDate": "2024-01-01T12:00:00Z", "function": "addAccount", "id": 0, "status": "cancelled", "todoDate": "2024-01-01T12:00:00Z"}