Get a marketing mailbox
get
/services/rest/connect/v1.4/marketingMailboxes/{id}
Request
Path Parameters
-
id: integer
The unique identifier of the marketing mailbox.
Response
Default Response
Root Schema : marketingMailboxes
Type:
object
The mailbox used to send and receive emails and process bounced messages.
Show Source
-
createdTime(optional):
string
The date and time when the marketing mailbox was created. This attribute is read-only.
-
id(optional):
integer
Minimum Value:
1
Maximum Value:9.223372036854776E18
The unique identifier of the marketing mailbox. -
incomingEmailSettings(optional):
object marketingMailboxes-incomingEmailSettings
The settings for incoming emails for a mailbox.
-
interface(optional):
[
"object",
"null"
]
The console, windows, and pages used by staff members and customers to access the application and interact with a single knowledge base. The interface name determines the URL for the web site, the name of the system executables, and the .cfg directory name. It is the reference to a resource in 'siteInterfaces' collection. Only ID or lookupName can be provided to specify the resource.
-
isDefault(optional):
[
"boolean",
"null"
]
Indicates whether the mailbox is the default mailbox for the interface. This attribute does not have a default value.
-
lookupName(optional):
string
Maximum Length:
255
The name used to look up the marketing mailbox. -
name(optional):
string
Maximum Length:
40
Pattern:^[^ ]*$
The name of the marketing mailbox. -
outgoingEmailSettings(optional):
object marketingMailboxes-outgoingEmailSettings
The settings for outgoing emails for a mailbox.
-
type(optional):
object namedIDs-marketingMailboxes-type
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
-
updatedTime(optional):
string
The date and time when the marketing mailbox was last updated. This attribute is read-only.
Nested Schema : marketingMailboxes-incomingEmailSettings
Type:
object
The settings for incoming emails for a mailbox.
Show Source
-
forceReplyBetweenLines(optional):
[
"boolean",
"null"
]
Indicates whether the Force Reply Between the Lines feature is enabled for outgoing emails from the mailbox. This attribute does not have a default value.
-
forwardRejectMessageAddress(optional):
[
"string",
"null"
]
Maximum Length:
255
Pattern:^(((([-_!#$%&'*+/=?^~`{|}\w]+(\.[.]?[-_!#$%&'*+/=?^~`{|}\w]+)*)|("[^"]+"))@[0-9A-Za-z]+([\-]+[0-9A-Za-z]+)*(\.[0-9A-Za-z]+([\-]+[0-9A-Za-z]+)*)+[;, ]*)+|((("[^"]+")?|([-_!#$%&'*+/=?^~`{|}\w[:blank:]])*)[[:blank:]]*[<]([-_!#$%&'*+/=?^~`{|}\w]+(\.[.]?[-_!#$%&'*+/=?^~`{|}\w]+)*))@[0-9A-Za-z]+([\-]+[0-9A-Za-z]+)*(\.[0-9A-Za-z]+([\-]+[0-9A-Za-z]+)*)+[>]|((("[^"]+")?|([-_!#$%&'*+/=?^~`{|}\w[:blank:]])*)[[:blank:]]*[(]([-_!#$%&'*+/=?^~`{|}\w]+(\.[.]?[-_!#$%&'*+/=?^~`{|}\w]+)*))@[0-9A-Za-z]+([\-]+[0-9A-Za-z]+)*(\.[0-9A-Za-z]+([\-]+[0-9A-Za-z]+)*)+[)])$
The address to which rejected messages are sent. -
isEnabled(optional):
[
"boolean",
"null"
]
Indicates whether incoming email option is enabled. This attribute does not have a default value.
Nested Schema : marketingMailboxes-outgoingEmailSettings
Type:
object
The settings for outgoing emails for a mailbox.
Show Source
-
displayName(optional):
[
"string",
"null"
]
Maximum Length:
80
Pattern:^[^ ]*$
The display name used in the outgoing emails from the mailbox. -
friendlyFromAddress(optional):
[
"string",
"null"
]
Maximum Length:
255
Pattern:^((([-_!#$%&'*+/=?^~`{|}\w]+(\.[.]?[-_!#$%&'*+/=?^~`{|}\w]+)*)|("[^"]+"))@[0-9A-Za-z]+([\-]+[0-9A-Za-z]+)*(\.[0-9A-Za-z]+([\-]+[0-9A-Za-z]+)*)+[; ]*)$
The from address used to brand outgoing emails as friendly. -
fromAddress(optional):
[
"string",
"null"
]
Maximum Length:
255
Pattern:^(((([-_!#$%&'*+/=?^~`{|}\w]+(\.[.]?[-_!#$%&'*+/=?^~`{|}\w]+)*)|("[^"]+"))@[0-9A-Za-z]+([\-]+[0-9A-Za-z]+)*(\.[0-9A-Za-z]+([\-]+[0-9A-Za-z]+)*)+[;, ]*)+|((("[^"]+")?|([-_!#$%&'*+/=?^~`{|}\w[:blank:]])*)[[:blank:]]*[<]([-_!#$%&'*+/=?^~`{|}\w]+(\.[.]?[-_!#$%&'*+/=?^~`{|}\w]+)*))@[0-9A-Za-z]+([\-]+[0-9A-Za-z]+)*(\.[0-9A-Za-z]+([\-]+[0-9A-Za-z]+)*)+[>]|((("[^"]+")?|([-_!#$%&'*+/=?^~`{|}\w[:blank:]])*)[[:blank:]]*[(]([-_!#$%&'*+/=?^~`{|}\w]+(\.[.]?[-_!#$%&'*+/=?^~`{|}\w]+)*))@[0-9A-Za-z]+([\-]+[0-9A-Za-z]+)*(\.[0-9A-Za-z]+([\-]+[0-9A-Za-z]+)*)+[)])$
The from address on the outgoing email. -
isEnabled(optional):
[
"boolean",
"null"
]
Indicates whether outgoing email is enabled. This attribute does not have a default value.
-
replyToAddress(optional):
[
"string",
"null"
]
Maximum Length:
255
Pattern:^(((([-_!#$%&'*+/=?^~`{|}\w]+(\.[.]?[-_!#$%&'*+/=?^~`{|}\w]+)*)|("[^"]+"))@[0-9A-Za-z]+([\-]+[0-9A-Za-z]+)*(\.[0-9A-Za-z]+([\-]+[0-9A-Za-z]+)*)+[;, ]*)+|((("[^"]+")?|([-_!#$%&'*+/=?^~`{|}\w[:blank:]])*)[[:blank:]]*[<]([-_!#$%&'*+/=?^~`{|}\w]+(\.[.]?[-_!#$%&'*+/=?^~`{|}\w]+)*))@[0-9A-Za-z]+([\-]+[0-9A-Za-z]+)*(\.[0-9A-Za-z]+([\-]+[0-9A-Za-z]+)*)+[>]|((("[^"]+")?|([-_!#$%&'*+/=?^~`{|}\w[:blank:]])*)[[:blank:]]*[(]([-_!#$%&'*+/=?^~`{|}\w]+(\.[.]?[-_!#$%&'*+/=?^~`{|}\w]+)*))@[0-9A-Za-z]+([\-]+[0-9A-Za-z]+)*(\.[0-9A-Za-z]+([\-]+[0-9A-Za-z]+)*)+[)])$
The reply-to-address on the outgoing email.
Nested Schema : namedIDs-marketingMailboxes-type
Type:
object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
-
id(optional):
integer
Minimum Value:
0
ID value -
lookupName(optional):
string
Maximum Length:
255
Name used to lookup this object
Examples
Use GET with the following syntax to retrieve data for an Outreach mailbox:
https://your_site_interface/services/rest/connect/version/marketingMailboxes/mailbox_id
Request URI example
https://mysite.example.com/services/rest/connect/v1.4/marketingMailboxes/3
Response body example
{
"id": 3,
"lookupName": "Offers",
"incomingEmailSettings": {
"forceReplyBetweenLines": true,
"forwardRejectMessageAddress": null,
"isEnabled": false
},
"interface": {
"links": [
{
"rel": "self",
"href": "https://mysite.example.com/services/rest/connect/v1.4/siteInterfaces/1"
},
{
"rel": "canonical",
"href": "https://mysite.example.com/services/rest/connect/v1.4/siteInterfaces/1"
},
{
"rel": "describedby",
"href": "https://mysite.example.com/services/rest/connect/v1.4/metadata-catalog/siteInterfaces",
"mediaType": "application/schema+json"
}
]
},
"isDefault": false,
"name": "Offers",
"outgoingEmailSettings": {
"displayName": "Global Wireless Offers",
"friendlyFromAddress": null,
"fromAddress": "offers@mail.example.com",
"isEnabled": false,
"replyToAddress": "offers@mail.example.com"
},
"type": {
"id": 2,
"lookupName": "Marketing"
},
"links": [
{
"rel": "self",
"href": "https://mysite.example.com/services/rest/connect/v1.4/marketingMailboxes/3"
},
{
"rel": "canonical",
"href": "https://mysite.example.com/services/rest/connect/v1.4/marketingMailboxes/3"
},
{
"rel": "describedby",
"href": "https://mysite.example.com/services/rest/connect/v1.4/metadata-catalog/marketingMailboxes",
"mediaType": "application/schema+json"
}
]
}