Welcome to Zuora Product Documentation

Explore our rich library of product information

Create an OAuth login for your Tax app to connect to Zuora

This task guides you through creating an Integration Hub login to store OAuth authentication details for your Zuora tenant, enabling app installations that require OAuth.

Some apps use OAuth to authenticate to your Zuora tenant. This article explains how to create a Integration Hub login that stores OAuth authentication details for you Zuora tenant. You can then select the Integration Hub login when you install an app that uses OAuth.

To create a Integration Hub login:

  1. In your Zuora tenant, select Administration > Manage Users from the Profile & Settings menu, then create a user . Apps that use OAuth to authenticate to your Zuora tenant will perform actions as this user. Zuora recommends that you create an API user specifically for this purpose. See Create an API User for more information.
  2. On the Users page in your Zuora tenant, select the user you created in the previous step, then create an OAuth client for the user. See Manage Users for more information.
    Note:
    • Zuora displays the Client ID and Client Secret for the OAuth client. Copy and paste these details in a note when Zuora displays them (this aids in inputting them in the next step). This is the only time you can see the Client Secret.
    • If the Client Id and Secret are not saved, or lost, you can simply remove the created OAuth client and create another one for the new Client ID and Client Secret.
  3. In Zuora Connect , navigate to My Connect > Tenants , then select Zuora from the New Login menu: Zuora Connect New Login Zuora The New Login dialog box opens.
  4. In the New Login dialog box: Zuora Connect New Login OAuth
    • Select your Zuora tenant's data center and environment type.

    • Select OAUTH from the drop-down menu.

    • Enter the Client ID and Client Secret for the OAuth client.

A tile for the new login displays on the Tenants page. An OAuth login has the token following the account name in the top of the tile.

Market Oauth Login

When you install an app that uses OAuth, select the OAuth login in the New Configuration dialog box. See Install an App for more information.