# Target Endpoint Documentation

## Target Overview

The Daasity Audiences product uses three different endpoints in Sailthru:

* [Event API](https://getstarted.sailthru.com/developers/api/event/) to add an event to a user profile that can be used to send a triggered email
* [Job Update API](https://getstarted.sailthru.com/developers/api/job-update/) to update user profiles that allow you to add / update data to be used to segment users
* [List API](https://getstarted.sailthru.com/developers/api/list/) to create or update users to be part of a list

For both the [Event API](#event-api) and [Job Update API](#update-api), Daasity will update the entire list of users generated by the audience and make an API to Sailthru to add / update those users.  The [List API](#list-api) only runs as part of the [Users Target](https://help.daasity.com/core-concepts/audiences-reverse-elt/pushing-audience-data-to-targets/sailthru/users-target) if we have selected to either update an existing list or create a new list

## Event API

Daasity updates the user profile in Sailthru based on the data provided by the Sailthru Events target

* Endpoint: <https://getstarted.sailthru.com/developers/api/event/>
* Frequency: Daily (available to run On-Demand via the UI)

| Daasity UI Section | Daasity Property | Sailthru Property                           |
| ------------------ | ---------------- | ------------------------------------------- |
| Event Information  | Event name       | event                                       |
| Data Mapping       | email            | id                                          |
| Data Mapping       | Source           | Property Name from Data Mapping Destination |

{% hint style="info" %}

* You must specify either email or another id to match with existing users
* Daasity can update Sailthru standard properties (not recommended) or create / update additional properties
  {% endhint %}

## Job Update API

Daasity creates new users or updates existing users based on the report / query that is used to generate the audience by providing the file to Sailthru and requesting an asynchronous update job to be executed

* Endpoint: <https://getstarted.sailthru.com/developers/api/job-update/>
* Frequency: Daily (available to run On-Demand via the UI)

<table><thead><tr><th width="230.33333333333331">Daasity UI Section</th><th>Daasity Property</th><th>Sailthru Property</th></tr></thead><tbody><tr><td>N/A</td><td>N/A</td><td>file - used to indicated that Daasity is sending a file to process</td></tr><tr><td>Data Mapping</td><td>JSON flag</td><td>Assigns "Simple" or "JSON" to file property</td></tr><tr><td>Data Mapping</td><td>email</td><td>id</td></tr><tr><td>Data Mapping</td><td>Source</td><td>$value</td></tr></tbody></table>

{% hint style="info" %}

* You must specify either email or another id to match with existing users
* Daasity can update Sailthru standard properties (not recommended) or create / update additional properties
  {% endhint %}

## List API

If the selection to "Add user to an existing list" or "Add user to a new list" is made in the [Users Target](https://help.daasity.com/core-concepts/audiences-reverse-elt/pushing-audience-data-to-targets/sailthru/users-target) the Daasity will execute the List API to perform the appropriate action as part of the User Target

* Endpoint: <https://getstarted.sailthru.com/developers/api/list/>
* Frequency: Daily (available to run On-Demand via the UI)

| Daasity UI Section | Daasity Property | Sailthru Property |
| ------------------ | ---------------- | ----------------- |
| User List Actions  | User List        | list              |

{% hint style="warning" %}
This endpoint will only execute if updating a list or adding new users to a list have been selected
{% endhint %}