# Tealium

Teleskope integrates with Tealium’s APIs to fulfill **Delete User** DSRs by deleting a visitor from a given **account** and **profile**.

## Requirements

In order to integrate Teleskope with Tealium for DSR requests, you must have:

* Your **Tealium Account ID**
* Your **Tealium Profile ID**
* Your **Tealium API Key** (Bearer token)
* *(Optional)* **API URL override**
  * Defaults to `https://api.tealiumiq.com/v2`. Provide a custom base URL only if your environment requires it.
* The data subject’s **Visitor ID** (passed directly in the endpoint path)

{% hint style="info" %}
Retrieval is not supported by this integration.
{% endhint %}

### Integrating with Tealium

To integrate Teleskope with Tealium:

1. Navigate to **Data Subject Rights → Third Party Integrations** and pick **Tealium**.
2. Enter the required fields for the integration and click **Save**:
   * **Account ID** (required)
   * **Profile ID** (required)
   * **API Key** (required)
   * **API URL** (optional; leave blank to use `https://api.tealiumiq.com/v2`)

### Parameter Defaults

* When Teleskope sends a **Delete User** request to Tealium, it includes these parameters by default:
  * **HTTP Method**: `DELETE`
  * **Endpoint**:

    ```
    {apiUrl}/accounts/{accountId}/profiles/{profileId}/visitors/{visitorId}
    ```
  * **Headers**:
    * `Authorization: Bearer <API Key>`
    * `Content-Type: application/json`
  * **Expected success codes**: `200` or `204`
* **Default Identifier for Tealium = `visitor_id`**\
  (The identifier value is sent as `{visitorId}` in the URL path.)

### Behavior and Notes

* The handler issues a single **DELETE** call against the visitors endpoint using your **Account ID**, **Profile ID**, and the subject’s **Visitor ID**.
* If the API response is not `200`/`204`, the error (including response body) is surfaced for troubleshooting.
* On success, Teleskope logs the operation and returns a standard “vendor deletion request submitted” message.

#### Helpful Links

[Tealium Visitor Privacy API Endpoints](https://docs.tealium.com/api/v3/visitor-privacy/endpoints/)