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