pem.exchange.changePrimaryEmailAddress

This method is supported by Operations starting from version 2.6.5

This method sets the new primary e-mail address for Hosted Exchange entity (Mailbox, Distribution List, Contact, Pubic Folder).

Two use-cases are possible:

  • E-mail address already assigned to the Hosted Exchange entity. The method sets this e-mail address as primary e-mail address.
  • E-mail address is not assigned to the Hosted Exchange entity. The method assigns this e-mail address to the Hosted Exchange entity and sets one as primary e-mail address.

Note: The mailbox_id, distribution_list_id, public_folder_id, and mail_contact_id optional parameters are mutually exclusive.

The method has the following input parameters:

Name

Type

Short Description

[mail_contact_id]

int

Contact ID.

[public_folder_id]

int

Public Folder ID.

[distribution_list_id]

int

Distribution List ID.

[mailbox_id]

int

Mailbox ID.

email_address

string

Specifies the primary e-mail address for the Hosted Exchange entity. This e-mail address should be based on domains, which belong to the Customer's Subscription.

The method has no output parameters.

Note: This method can also be called under Reseller permissions.