# Zuora

### Connect to Zuora

1\. Go to the **Resources** page and click the <img src="https://3574406564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MB_fx7PCUqvFEdrucJC%2Fuploads%2Fct5RJC2cjHhrvymOWWGx%2Fimage.png?alt=media&#x26;token=b4ff0c44-5510-49d1-97dd-a155af254113" alt="" data-size="line">  button.&#x20;

2\. Select **Zuora**.

3\. Enter your account credentials and click **Connect**. Please follow the instructions [here](#getting-started) to get your credentials.

* **`Client ID`**: Your OAuth user Client ID&#x20;
* **`Client Secret`**: Your OAuth user Client Secret&#x20;
* **`Data Query Type`**: Choose between `Live`, or `Unlimited` - the optimized, replicated database at 12 hours freshness for high volume extraction.&#x20;
* **`Start Date`**: Retrieve data after this date. The date should be UTC date and time in the format of `YYYY-MM-DD`.&#x20;
* **`Tenant Endpoint Location`**: Please choose the right endpoint where your Tenant is located. &#x20;
* **`Query Window (in days)`**: Amount of days for each data-chunk beginning from **`Start Date`**. Bigger the value - faster the fetch. (0.1 - as for couple of hours, 1 - as for a Day; 364 - as for a Year).&#x20;

{% hint style="info" %}
Visit [here](https://www.zuora.com/developer/api-reference/#section/Introduction/Access-to-the-API) to see more info about each parameter.
{% endhint %}

4\. Choose tables to import and click **Finish Setup**.&#x20;

5\. You will see a  <img src="https://3574406564-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MB_fx7PCUqvFEdrucJC%2F-MgBh5PshcmRFk38itib%2F-MgBo4LSmdK4OS-NqLZy%2Fsyncing.png?alt=media&#x26;token=452494f9-e4be-48fa-9644-bee7d969c46c" alt="" data-size="line"> icon next to your resource. It may take a few minutes to several hours depending on the data size and the number of your tables. Once your data is ready, you will receive a notification email.&#x20;

### Setup Guide <a href="#getting-started" id="getting-started"></a>

#### Create an API user role[​](https://docs.airbyte.com/integrations/sources/zuora#create-an-api-user-role) <a href="#create-an-api-user-role" id="create-an-api-user-role"></a>

1. Log in to your `Zuora acccount`.
2. In the top right corner of the Zuora dashboard, select `Settings` > `Administration Settings`.
3. Select `Manage User Roles`.
4. Select `Add new role` to create a new role, and fill in neccessary information up to the form.

#### Assign the role to a user[​](https://docs.airbyte.com/integrations/sources/zuora#assign-the-role-to-a-user) <a href="#assign-the-role-to-a-user" id="assign-the-role-to-a-user"></a>

1. From the `administration` page, click `Manage Users`.
2. Click `add single user`.
3. Create a user and assign it to the role you created in `Create an API user role` section.
4. You should receive an email with activation instructions. Follow them to activate your API user.

   For more information visit [Create an API User page](https://knowledgecenter.zuora.com/Billing/Tenant_Management/A_Administrator_Settings/Manage_Users/Create_an_API_User)

#### Create Client ID and Client Secret[​](https://docs.airbyte.com/integrations/sources/zuora#create-client-id-and-client-secret) <a href="#create-client-id-and-client-secret" id="create-client-id-and-client-secret"></a>

1. From the `administration` page, click `Manage Users`.
2. Click on User Name of the target user.
3. Enter a client name and description and click `create`.
4. A pop-up will open with your Client ID and Client Secret.

   Make a note of your Client ID and Client Secret because they will never be shown again. You will need them to configure Acho Zuora Connector.
5. You're ready to set up Zuora connector in Acho, using created `Client ID` and `Client Secret`!