This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
api-contacts [2017/04/03 11:35] ben [Response] |
api-contacts [2018/05/23 11:29] (current) benc |
||
|---|---|---|---|
| Line 52: | Line 52: | ||
| ===== Add a Contact ===== | ===== Add a Contact ===== | ||
| - | This endpoint is used to add a new [[/contacts|Contact]] to the Sentori Account. If no [[/contact-fields|Contact Fields]] need to be set then the [[/contacts|Contact]] can be added using a GET request, when including [[/contact-fields|Contact Fields]] in a request then they must be in a POST request body. | + | This endpoint is used to add a new [[/contacts|Contact]] to the Sentori Account. |
| Note: The EmailAddress [[/contact-fields|Contact Field]] should not appear in the Add request body, and will fail if it doesn't match the request URI. | Note: The EmailAddress [[/contact-fields|Contact Field]] should not appear in the Add request body, and will fail if it doesn't match the request URI. | ||
| Line 59: | Line 59: | ||
| |URI| <nowiki>https://api.sentoriapp.com/v2.0/contact/add/joe%40example.sentoriapp.com/</nowiki>| | |URI| <nowiki>https://api.sentoriapp.com/v2.0/contact/add/joe%40example.sentoriapp.com/</nowiki>| | ||
| - | |Method| GET, or POST if sending additional fields| | + | |Method| POST| |
| ==== Request Body ==== | ==== Request Body ==== | ||
| - | Request body is only required if including [[/contact-fields|Contact Fields]]. The example below would add a new [[/contacts|Contact]] with the FirstName and LastName [[/contact-fields|Contact Fields]] being set. | + | Request body is only needed if including [[/contact-fields|Contact Fields]]. The example below would add a new [[/contacts|Contact]] with the FirstName and LastName [[/contact-fields|Contact Fields]] being set. |
| |Example|<code javascript>{ | |Example|<code javascript>{ | ||
| Line 145: | Line 145: | ||
| See the [[#get-a-contact|Get a Contact]] endpoint's Example Response for details. | See the [[#get-a-contact|Get a Contact]] endpoint's Example Response for details. | ||
| + | |||
| + | In the described situation of the original Request's URI //and// body containing an Email Address and a Contact eixsting for both of them, the Contact with the body's Email Address is returned. | ||
| + | |||
| + | |||
| + | ===== Delete a Contact ===== | ||
| + | |||
| + | This endpoint is used to delete an existing [[/contacts|Contact]] from the Sentori Account. | ||
| + | |||
| + | ==== Endpoint ==== | ||
| + | |||
| + | |URI| <nowiki>https://api.sentoriapp.com/v2.0/contact/delete/joe%40example.sentoriapp.com/</nowiki>| | ||
| + | |Method| POST| | ||
| + | |||
| + | ==== Request Body ==== | ||
| + | |||
| + | Leave blank. | ||
| + | |||
| + | |||
| + | |||
| + | |||
| ===== Get Contact Structure ===== | ===== Get Contact Structure ===== | ||
| Line 213: | Line 233: | ||
| |URI| <nowiki>https://api.sentoriapp.com/v2.0/contact/subscribe/joe%40example.sentoriapp.com/MailingListExternalID/</nowiki>| | |URI| <nowiki>https://api.sentoriapp.com/v2.0/contact/subscribe/joe%40example.sentoriapp.com/MailingListExternalID/</nowiki>| | ||
| - | |Method| GET | | + | |Method| POST | |
| ===== Unsubscribe Contact from Mailing List ===== | ===== Unsubscribe Contact from Mailing List ===== | ||
| Line 223: | Line 243: | ||
| |URI| <nowiki>https://api.sentoriapp.com/v2.0/contact/unsubscribe/joe%40example.sentoriapp.com/MailingListExternalID/</nowiki>| | |URI| <nowiki>https://api.sentoriapp.com/v2.0/contact/unsubscribe/joe%40example.sentoriapp.com/MailingListExternalID/</nowiki>| | ||
| - | |Method| GET | | + | |Method| POST | |
| ===== Unsubscribe Contact ===== | ===== Unsubscribe Contact ===== | ||
| Line 233: | Line 253: | ||
| |URI| <nowiki>https://api.sentoriapp.com/v2.0/contact/unsubscribe/joe%40example.sentoriapp.com/</nowiki>| | |URI| <nowiki>https://api.sentoriapp.com/v2.0/contact/unsubscribe/joe%40example.sentoriapp.com/</nowiki>| | ||
| - | |Method| GET | | + | |Method| POST | |
| ===== Import Contacts ===== | ===== Import Contacts ===== | ||
| Line 298: | Line 318: | ||
| |URI| <nowiki>https://api.sentoriapp.com/v2.0/contact/import/{{UploadGroupExternalID}}/attach/{{DocumentExternalID}}</nowiki>| | |URI| <nowiki>https://api.sentoriapp.com/v2.0/contact/import/{{UploadGroupExternalID}}/attach/{{DocumentExternalID}}</nowiki>| | ||
| - | |Method| GET | | + | |Method| POST | |