# 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](/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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.daasity.com/core-concepts/audiences-reverse-elt/pushing-audience-data-to-targets/sailthru/target-endpoint-documentation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.