====== API Automation Endpoints ======

Endpoints to work with Sentori's Automations: Autoresponders and RSS Automations.

===== Add Contact to Autoresponder =====

This endpoint is used to add a Contact to an Autoresponder.

Can be used as a way to send an Email to a Contact from an external system: create an Autoresponder in Sentori that has a single Send Email step.


==== Endpoint ====

|URI|<nowiki>https://api.sentoriapp.com/v2.0/automation/{AutomationExternalID}/addcontact/{Contact EmailAddress}/</nowiki>|
|Method|POST|



==== Request Body ====

JSON data in the Request Body can be used to provide additional values to merge into any Emails in the Autoresponder.

When preparing the Emails to use in your Autoresponder, you can manually enter "Transaction Data" Mergefields into the Email content where you'd like to merge in values from this JSON data.

The syntax for Transaction Data Mergefields is <nowiki>{{trx:MergefieldName}}</nowiki> and "MergefieldName" must match the name in the JSON data.  You can also include a default value which is used if either the property isn't found in the JSON data or its value is blank, e.g. <nowiki>{{trx:DiscountCode default=n/a}}</nowiki>

The JSON data must describe a single "flat" object (i.e. one consisting only of name/value pairs as shown in the example below), it cannot be an array.

|Example Email Content|<code>Order Confirmation
Item: {{trx:ProductName}}
Price: {{trx:ProductPrice}}
Date: {{trx:PurchaseDate}}
Discount Code: {{trx:DiscountCode default=n/a}}</code>|

|Example JSON Request Body|<code javascript>{
	"ProductName":"46inch LCD Television",
	"ProductPrice":"£429.99",
	"PurchaseDate":"31st August 2016"
}</code>|

|Example Merged Content|<code>Order Confirmation
Item: 46inch LCD Television
Price: £429.99
Date: 31st August 2016
Discount Code: n/a</code>|


==== Response ====

|HTTP Status|Description|Response Body|
|400|Bad Request|<code javascript>{
	"Code":"-1",
	"Message":"Invalid JSON found in Request Body."
}</code>|


For other response codes, see the [[api-errors|Error List]].

\\
\\

===== Get All Autoresponders =====

This endpoint is used to get a list of all the [[automation|Autoresponders]] in your Sentori Account.


==== Endpoint ====

|URI|<nowiki>https://api.sentoriapp.com/v2.0/automation/autoresponders/</nowiki>|
|Method|GET|



==== Response ====

|Field| Type|Description |
|ExternalID| string| ID of the Autoresponder.|
|Name|string| Name of the Autoresponder.|
|Description| string| Description of the Autoresponder.|

|Example|<code javascript>
[
	{
		"ExternalID": "ABCD1234",
		"Name": "New signups",
		"Description": "Send new signups some initial offers."
	},
	{
		"ExternalID": "ABCD1235",
		"Name": "10 step course",
		"Description": "Send the 10 emails about the course each week."
	}
]
</code>|