MailingWebservice
Query, create, update, remove or start mailings as well as send emails on demand in Optimizely Campaign.
| Method | Description |
|---|---|
| cancel | Cancels a running mailing. |
| copy | Creates a copy of an existing mailing. |
| create | Creates a mailing. |
| decodeTrackingLinks | Converts all links found in the given content back to normal links. |
| encodeTrackingLinks | Converts all links found in the given content to tracking links. |
| getAttachmentIds | Queries the IDs of one or more attachments of a mailing. |
| getCharset | Queries the character set for the content (subject + body) of a mailing. |
| getColumnNames | Queries the column names of each mailing. |
| getContent | Queries the content of a mailing of a specific MIME type. |
| getCount | Counts mailings of a specific type. |
| getCreatedDate | Queries the creation date of a mailing. |
| getDataSet | Queries the data of each mailing. |
| getDataSetFlat | Queries the values of each mailing. |
| getDescription | Queries the description of a mailing. |
| getFailedRecipientCount | Counts the recipients that have been skipped during dispatch. |
| getFromEmailPrefix | Queries the email prefix of the sender of a mailing. |
| getFromName | Queries the name (not the email address) of the sender of a mailing. |
| getHeader | Queries the header value of a mailing. |
| getIds | Queries the IDs of all mailings of a specific type. |
| getIdsInStatus | Queries the IDs of all mailings of a specific type and status. |
| getMaxMailsPerHour | Queries the maximum sending rate (emails per hour) of a mailing. |
| getMaxRecipients | Queries the value of the option Maximum number of recipients. |
| getMimeType | Queries the MIME type of a mailing. |
| getName | Queries the name of a mailing. |
| getOverallRecipientCount | Counts the recipients to whom a mailing was sent or tried to send. |
| getPredictedRecipientCount | Counts the recipients that will receive a mailing once it is started. |
| getProperty | Queries the value of a specific mailing property. |
| getRecipientFilterIds | Queries the target group IDs of a mailing. |
| getRecipientListIds | Queries the IDs of the recipient lists of a mailing. |
| getScheduleDate | Queries the sending date of a mailing. |
| getSendingFinishedDate | Queries the date at which the sending of a mailing finished. |
| getSendingStartedDate | Queries the date at which a mailing was started. |
| getSendingStatus | Queries the sending status of a mailing to a specific recipient. |
| getSentRecipientCount | Counts the recipients to whom a mailing was successfully sent. |
| getStatus | Queries the status of a mailing. |
| isClickTrackingEnabled | Queries whether click tracking is activated for a mailing. |
| isDefaultRecipientFilterEnabled | Queries whether the default target group is used for a mailing. |
| isMaxRecipientsPercentage | Queries whether the maximum number of recipients is given as a percentaged value. |
| isMaxRecipientsRandomOrder | Queries whether the recipients should be selected on a random basis. |
| isOpenTrackingEnabled | Queries whether open tracking is activated for a mailing. |
| pause | Pauses a mailing that is in the status SENDING. |
| remove | Deletes a mailing. |
| resume | Resumes a paused mailing. |
| sendMail | Sends a mailing to a recipient. |
| sendMails | Sends a mailing to multiple recipients. |
| sendTestMail | Sends a test email to a recipient. |
| sendTestMail2 | Sends a test email to a recipient. |
| sendTestMails | Sends test emails to multiple recipients. |
| sendTestMailToAll | Sends test emails to all recipients of a specific recipient list. |
| setAttachmentIds | Defines the IDs for one or more attachments of a mailing. |
| setCharset | Defines the character set for the content (subject + body) of a mailing. |
| setClickTrackingEnabled | Activates or deactivates click tracking for a mailing of a specific MIME type (click tracking is set separately for the two MIME types). |
| setContent | Defines the content for a mailing of a specific MIME type. |
| setDefaultRecipientFilterEnabled | Activates or deactivates the default target group. |
| setDescription | Defines the description of a mailing. |
| setFrom | Defines the sender identification of a mailing. |
| setHeader | Defines a RFC822-compliant header value. |
| setMaxMailsPerHour | Defines the maximum sending rate (emails per hour) for a mailing. |
| setMaxRecipients | Activates or deactivates the options Maximum number of recipients and Random order and sets absolute values for them. |
| setMaxRecipientsPercentage | Activates or deactivates the options Maximum number of recipients and Random order and sets absolute percentaged values for them (a float from 0 to 1). |
| setMimeType | Defines the MIME type of a mailing. |
| setName | Defines the name of a mailing. |
| setOpenTrackingEnabled | Activates or deactivates open tracking for a mailing. |
| setProperty | Defines the value of a specific mailing property. |
| setRecipientFilterIds | Defines target group IDs for a mailing. |
| setRecipientListIds | Defines the IDs of the recipient lists to be used for a mailing. |
| setReplyToAddress | Defines the the reply to address for a mailing. |
| setReplyToName | Defines the displayed name for the reply address (reply to). |
| setSubject | Defines the subject of a mailing. |
| start | Starts a mailing. |
| validateContent | Validates the content of a mailing. |
Deprecated methods
| Method | Description |
|---|---|
| getRecipientFilterId | Use getRecipientFilterIds. |
| setRecipientFilterId | Use setRecipientFilterIds. |
Mailing type
The following mailing types are supported:
- regular: This is a regular mailing.
- event: This mailing type is used for trigger emails. After the mailing has been started you can send mails to any recipient.
- confirmation: Used for opt-in processes only, see OptinProcessWebservice.
- template: Can only be copied. Cannot be started and no emails can be sent.
- campaign: All mailings of a campaign (not the campaign itself).
- split: This is a split mailing of an A/B test.
MIME types
The following MIME types are supported:
- text/plain: Text emails
- text/html: HTML emails
- multipart/alternative: Text and HTML emails
- text/optivosms: SMS messages
Updated about 2 months ago
Next