post_domain_bulletin

📘
Note:
To get a list of all current bulletins, use the get_domain method.

Syntax

{
    <credentials object>, 
    "domain": <domain_name>, 
    "bulletin": <bulletin_name>,
    "type": auto | manual, 
    "test_email": <email_address> 
    },
}

Request fields for post_domain_bulletin

The following fields can be used in the post_domain_bulletin method:

Field name	Obligation	Definition/Value
bulletin	Required	The name of the bulletin you want to view.
domain	Required	The name of the domain.
test_email	Optional	Send the bulletin to only the specified email address. If not specified, the bulletin is sent to all mailboxes in the domain.
type	Required	The bulletin type. Allowed values are: auto — The bulletin is automatically sent to new users when their accounts are created. manual — The bulletin is sent only when the post_domain_bulletin method is run.

Response fields for post_domain_bulletin

The following fields may be returned in response to the post_domain_bulletin method:

Field name	Obligation	Description/Value
error	Returned if success = false	A text string that explains the error.
error_number	Returned if success = false	A number that represents the error.
success	Always returned	Indicates whether the request was successful or not. Allowed values are true and false.

Examples for post_domain_bulletin

Example 1

Sends a bulletin to just [email protected].

Request

{
   "credentials": {
     "user": "[email protected]",
     "password": "sw0rdfish"
   },
   "domain": "example.com",
   "bulletin": "Welcome Message", 
   "type": "autol"
   "test_email": "[email protected]"
}

Response

{
  "success": true
}

Example 2

Sends a bulletin to all users in the domain example.com.

Request

{
  credentials": {
    user": "[email protected]",
    password": "pencil75"
  },
  "domain": "example.com",
  "bulletin": "Welcome Message",
  "type": "auto"
}

Response

{
  "success": true
}