Skip to content
ATTENTION
You are viewing the documentation of the current development state (git-main / nightly).
The current latest stable documentation can be found here.

EmailSender

EmailSender.add

add a new sender email address for a given email-address either by id or emailaddr

Permission

admin customer

Parameter

FieldTypeDescription
idintoptional id of email-address to add the allowed sender for (must have an account)
emailaddrstringoptional address of email-address to add the allowed sender for (must have an account)
customeridintoptional, required when called as admin (if $loginname is not specified)
loginnamestringoptional, required when called as admin (if $customerid is not specified)
allowed_senderstringrequired email-address or @domain.tld notation (wildcard) of allowed sender entry for the given account

Response

string as json-encoded array

EmailSender.update

You cannot update an email sender alias. You need to delete the entry and create a new one.

EmailSender.get

You cannot directly get an email sender alias. Try EmailSender.listing()

EmailSender.listing

List email senders for a given email address

Permission

admin,customer

Parameter

FieldTypeDescription
idintoptional, the id of the email-address to list allowed senders from
emailaddrstringoptional, the email-address to list allowed senders from
customeridintoptional, admin-only, the customer-id
loginnamestringoptional, admin-only, the loginname

Response

string as json-encoded array count|list

EmailSender.listingCount

returns the total number of allowed sender addresses for a given email address

Permission

admin customer

Parameter

FieldTypeDescription
idintoptional, the id of the email-address to list allowed senders from
emailaddrstringoptional, the email-address to list allowed senders from
customeridintoptional, admin-only, the customer-id
loginnamestringoptional, admin-only, the loginname

Response

string as json-encoded response message

EmailSender.delete

delete email-sender entry for given email-address by either id or email-address and sender-id

Permission

admin,customer

Parameter

FieldTypeDescription
idintoptional, the email-address-id
emailaddrstringoptional, the email-address to delete the forwarder from
customeridintoptional, required when called as admin (if $loginname is not specified)
loginnamestringoptional, required when called as admin (if $customerid is not specified)
senderidintid of the sender to delete

Response

string as json-encoded array