# Zuora

## Requirements

<table><thead><tr><th width="192.671875">Parameter</th><th>Description</th></tr></thead><tbody><tr><td>Client ID</td><td>OAuth 2.0 Client ID for Zuora API access.</td></tr><tr><td>Client Secret</td><td>OAuth 2.0 Client Secret for Zuora API access.</td></tr><tr><td>Base API URL</td><td>Zuora’s REST API endpoint (US, EU, etc.).</td></tr></tbody></table>

Teleskope securely obtains and manages Bearer tokens using OAuth 2.0 Client Credentials flow.

### Integrating with Zuora

To enable the Zuora integration in Teleskope:

1. Navigate to **Integrations** in the Teleskope UI.
2. Select **Zuora** from the list of available third-party vendors.
3. Provide the required credentials:

* **Client ID** (from Zuora OAuth setup)
* **Client Secret**
* **Base API URL** (e.g. `https://rest.apis.zuora.com`)

4. Click **Save** to activate the integration.

Once configured, Teleskope can automatically issue deletion and retrieval requests to Zuora for qualified data subject rights requests.

### Supported Endpoints & Identifiers

| Endpoint        | Default Identifier |
| --------------- | ------------------ |
| Account         | Email              |
| Contacts        | Email              |
| Payment Methods | Email              |
| Subscriptions   | Email              |
| Invoices        | Email              |
| Usage           | Email              |

*Zuora objects are always matched using the user’s email address (Contact.WorkEmail).*\
Deletion and retrieval requests require providing this identifier.

### Parameter Defaults

Teleskope’s Zuora integration enforces the following default behavior:

| Parameter Name      | Default Value       | Notes                                                       |
| ------------------- | ------------------- | ----------------------------------------------------------- |
| **identifier type** | Email               | Required. Always used to search Contacts to find AccountId. |
| **OAuth2 Scope**    | client\_credentials | Always used for authentication.                             |

Refer to Zuora's REST API [documentation](https://developer.zuora.com/v1-api-reference/introduction/) for more.


---

# 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/zuora.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.
