Retrieve an instance of marketingMailboxes

get

/services/rest/connect/latest/marketingMailboxes/{id}

Request

Path Parameters

Response

Supported Media Types

Default Response

Body ()
An email box specified in the system and used to send and receive email and process bounced messages in the system.
Root Schema : marketingMailboxes
Type: object
An email box specified in the system and used to send and receive email and process bounced messages in the system.
Show Source
Nested Schema : marketingMailboxes-incomingEmailSettings
Type: object
Settings for incoming emails for an email box
Show Source
  • Indicates whether the Force Reply Between the Lines feature is enabled on outgoing emails from the mailbox
  • Maximum Length: 80
    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 that rejected messages are sent to
  • Indicates whether incoming email is enabled
Nested Schema : siteInterfaces
Type: object
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.
Show Source
Nested Schema : marketingMailboxes-outgoingEmailSettings
Type: object
Settings for outgoing emails for an email box
Show Source
  • Maximum Length: 80
    Pattern: ^[^ ]*$
    The display name used in the outgoing emails from the mailbox
  • Maximum Length: 80
    Pattern: ^((([-_!#$%&'*+/=?^~`{|}\w]+(\.[.]?[-_!#$%&'*+/=?^~`{|}\w]+)*)|("[^"]+"))@[0-9A-Za-z]+([\-]+[0-9A-Za-z]+)*(\.[0-9A-Za-z]+([\-]+[0-9A-Za-z]+)*)+[; ]*)$
    The friendly from address used to brand outgoing emails from the mailbox
  • Maximum Length: 80
    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 email address specified on the outgoing email from the mailbox
  • Indicates whether outgoing email is enabled
  • Maximum Length: 80
    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 used on the outgoing emails from the mailbox
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
Nested Schema : namedIDs-siteInterfaces-language
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

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"
    }
  ]
}