> For the complete documentation index, see [llms.txt](https://help.daasity.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.daasity.com/core-concepts/audiences-reverse-elt/pushing-audience-data-to-targets/sailthru/target-endpoint-documentation.md).

# Target Endpoint Documentation

This page outlines the technical details of how Daasity pushes data into Sailthru using the Event, List and Job API to update users and trigger automated emails in Sailthru

## 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](/core-concepts/audiences-reverse-elt/pushing-audience-data-to-targets/sailthru/users-target.md) 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](/core-concepts/audiences-reverse-elt/pushing-audience-data-to-targets/sailthru/users-target.md) 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 %}
