# Chargebee

Teleskope integrates with Chargebee’s API to fulfill **Delete User** DSRs by clearing personal data on the customer record.

## Requirements

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

* Your **Chargebee Site Name** (subdomain)
  * The default API base is `https://<site-name>.chargebee.com/api/v2`.
* Your **Chargebee API key** (used for Basic Auth).
* *(Optional)* **API URL override**
  * If you use a non-standard or regional base URL, provide it here. Otherwise Teleskope constructs `https://<site-name>.chargebee.com/api/v2` automatically.
* The user’s **email address** as the identifier (used to look up the customer).

### Integrating with Chargebee

To integrate Teleskope with Chargebee

1. Navigate to **Data Subject Rights → Third Party Integrations** and pick **Chargebee**.
2. Enter the required fields for the integration and click **Save**:
   * **API Key** (required)
   * **Site Name** (required)
   * **API URL** (optional; leave blank to use `https://<site>.chargebee.com/api/v2`)

### Parameter Defaults

* When Teleskope sends a **Delete User** request to Chargebee, it performs these steps by default:
  * **Lookup by email**:\
    `GET /customers?email[is]={email}`
  * If a match is found, **clear personal data** on the first customer returned:\
    `POST /customers/{customerId}/clear_personal_data`
  * **Authentication & headers**:
    * `Authorization`: Basic Auth (API key as username, empty password)
    * `Accept`: `application/json`
    * `Content-Type`: `application/x-www-form-urlencoded`
  * **Expected success codes**: `200` or `204`
* **Default Identifier for Chargebee = `email`**\
  (The handler uses the user’s email to find the customer ID.)

### Behavior and Notes

* If multiple customers are returned for the email lookup, the **first** one in the list is used.
* If **no customer** is found for the provided email, the request fails with an error.
* On success, Teleskope logs the operation and returns a standard “vendor deletion request submitted” message.

#### Helpful Links

[Chargebee: How to delete the personal data of my customers](https://www.chargebee.com/docs/billing/2.0/kb/billing/how-to-delete-the-personal-data-of-my-customers)

[Chargebee API docs](https://apidocs.chargebee.com/docs/api/customers)


---

# 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://docs.teleskope.ai/the-platform/data-subject-rights/enroll-third-party-integrations/chargebee.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.