Get a service mailbox
get
/services/rest/connect/v1.4/serviceMailboxes/{id}
Request
Path Parameters
-
id(required): integer
The unique identifier of the service mailbox.
Response
Default Response
Root Schema : serviceMailboxes
Type:
object
The email box dedicated to collect email inquiries sent by customers.
Show Source
-
createdTime:
string
The date and time when the service mailbox was created. This attribute is read-only.
-
id:
integer
Minimum Value:
1
Maximum Value:9223372036854776000
The unique identifier of the service mailbox. -
incomingEmailSettings:
object serviceMailboxes-incomingEmailSettings
The settings for incoming emails for a mailbox.
-
interface:
[
"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:
[
"boolean",
"null"
]
Indicates whether the mailbox is the default mailbox for the interface. This attribute does not have a default value.
-
lookupName:
string
Maximum Length:
255
The name used to look up the service mailbox. -
name:
string
Maximum Length:
40
Pattern:^[^ ]*$
The name of the service mailbox in the language of the current interface. -
outgoingEmailSettings:
object serviceMailboxes-outgoingEmailSettings
The settings for outgoing emails for a mailbox.
-
type:
object namedIDs-serviceMailboxes-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:
string
The date and time when the service mailbox was last updated. This attribute is read-only.
Nested Schema : serviceMailboxes-incomingEmailSettings
Type:
object
The settings for incoming emails for a mailbox.
Show Source
-
forceReplyBetweenLines:
[
"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:
[
"string",
"null"
]
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 to which rejected messages are sent. -
isEnabled:
[
"boolean",
"null"
]
Indicates whether incoming email option is enabled. This attribute does not have a default value.
Nested Schema : serviceMailboxes-outgoingEmailSettings
Type:
object
The settings for outgoing emails for a mailbox.
Show Source
-
displayName:
[
"string",
"null"
]
Maximum Length:
80
Pattern:^[^ ]*$
The display name used in the outgoing emails from the mailbox. -
friendlyFromAddress:
[
"string",
"null"
]
Maximum Length:
80
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:
[
"string",
"null"
]
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 from address on the outgoing email. -
isEnabled:
[
"boolean",
"null"
]
Indicates whether outgoing email is enabled. This attribute does not have a default value.
-
replyToAddress:
[
"string",
"null"
]
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 on the outgoing email.
Nested Schema : namedIDs-serviceMailboxes-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:
integer
Minimum Value:
0
ID value -
lookupName:
string
Maximum Length:
255
Name used to lookup this object
Examples
Use GET with the following syntax to retrieve data for a Service mailbox:
https://your_site_interface/services/rest/connect/version/serviceMailboxes/mailbox_id
Request URI example
https://mysite.example.com/services/rest/connect/v1.4/serviceMailboxes/4
Response body example
{
"id": 4,
"lookupName": "Customer Care",
"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": "Customer Care",
"outgoingEmailSettings": {
"displayName": "Global Wireless Customer Care",
"friendlyFromAddress": null,
"fromAddress": "customercare@mail.example.com",
"isEnabled": false,
"replyToAddress": "customercare@mail.example.com"
},
"type": {
"id": 1,
"lookupName": "Service"
},
"links": [
{
"rel": "self",
"href": "https://mysite.example.com/services/rest/connect/v1.4/serviceMailboxes/4"
},
{
"rel": "canonical",
"href": "https://mysite.example.com/services/rest/connect/v1.4/serviceMailboxes/4"
},
{
"rel": "describedby",
"href": "https://mysite.example.com/services/rest/connect/v1.4/metadata-catalog/serviceMailboxes",
"mediaType": "application/schema+json"
}
]
}