diff options
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 24 |
1 files changed, 24 insertions, 0 deletions
@@ -47,6 +47,30 @@ try { * [Transmissions](https://github.com/MessageSystems/php-sdk/tree/master/examples/transmission/) * Read our REST API documentation - <http://www.sparkpost.com/docs/introduction> +## Field Descriptions +### Transmissions +| Field Name | Required? | Description | Data Type | +| ------------ | ----------- | ------------- | ----------- | +| description | no | Field for describing what this transmission is for the user | String | +| campaign | no | Field for assigning a given transmission to a specific campaign, which is a logical container for similar transmissions | String | +| metadata | no | Field for adding arbitrary key/value pairs which will be included in open/click tracking | Object (Simple) | +| substitutionData | no | Field for adding transmission level substitution data, which can be used in a variety of fields and in content | Object (Complex) | +| trackOpens | no | Field for enabling/disabling transmission level open tracking (default: true) | Boolean | +| trackClicks | no | Field for enabling/disabling transmission level click tracking (default: true) | Boolean | +| useDraftTemplate | no | Field for allowing the sending of a transmission using a draft of a stored template (default: false) | Boolean | +| replyTo | no | Field for specifying the email address that should be used when a recipient hits the reply button | String | +| subject | yes | Field for setting the subject line of a given transmission | String | +| from | yes | Field for setting the from line of a given transmission | String or Object | +| html | yes** | Field for setting the HTML content of a given transmission | String | +| text | yes** | Field for setting the Plain Text content of a given transmission | String | +| rfc822 | no** | Field for setting the RFC-822 encoded content of a given transmission | String | +| template | no** | Field for specifying the Template ID of a stored template to be used when sending a given transmission | String | +| customHeaders | no | Field for specifying additional headers to be applied to a given transmission (other than Subject, From, To, and Reply-To) | Object (Simple) | +| recipients | yes** | Field for specifying who a given transmission should be sent to | Array of Objects | +| recipientList | no** | Field for specifying a stored recipient list ID to be used for a given transmission | String | + +** - If using inline content then html or text are required. If using RFC-822 Inline Content, then rfc822 is required. If using a stored recipient list, then recipientList is required. If using a stored template, then template is required. + ## Tips and Tricks ### General * You _must_ provide at least an API key when instantiating the SparkPost Library - `[ 'key'=>'184ac5480cfdd2bb2859e4476d2e5b1d2bad079bf' ]` |