--- title: "Manage API credentials through Enterprise Hub" slug: "manage-api-credentials-through-enterprise-hub" updated: 2026-10-15T00:33:28Z published: 2026-10-15T00:33:28Z canonical: "help.servicetitan.com/manage-api-credentials-through-enterprise-hub" --- > ## Documentation Index > Fetch the complete documentation index at: https://help.servicetitan.com/llms.txt > Use this file to discover all available pages before exploring further. # Manage API credentials through Enterprise Hub ## Overview Use the *API & Integrations* module in Enterprise Hub to enable API credentials on your account and simplify Client ID & Secret key management. --- ### #### Who uses this feature - Applies to all business types #### Feature configuration - This feature requires an Enterprise Hub network. Contact your Customer Success Manager to request a network or contact [technical support](https://go.servicetitan.com/#/ask) for details. Things to know - To access API & Integrations, your users must have the appropriate permissions added to their roles. For more, see [Manage user roles in Enterprise Hub](/construction/docs/create-and-edit-user-roles-in-enterprise-hub-1). - Use the *API & Integrations* module only if you consider your organization to be the resource owner of the data under all the tenants. - Contact your customer success manager (CSM) and make sure all your Tenant IDs are added to the Enterprise Hub network. - A network is a set of all your tenant IDs in Enterprise Hub. - A group is a subset of your tenant IDs that you create to connect to an App. - Generate one pair of Client ID & Secret key for each group and App and use the same pair across all the tenant IDs when making the API call. ## Use cases - **Customer**: Good Plumbing with 50 tenants (IDs). Tenant 1, Tenant 2, Tenant 3 … Tenant 50 - **Network**: Good Plumbing Network consists of all 50 tenants (IDs). Tenant 1, Tenant 2, and more. - **Group**: A group is a full set or a subset of the tenants that are a part of the network connecting to the same App. - For example, Group 1: Tenant 1, Tenant 2, Tenant 15, Tenant 50: Connecting to App 1. Group 2: Tenant 1, Tenant 2, Tenant 25, Tenant 40: Connecting to App 2. - **Client ID & Secret key:** A single pair of Client ID & Secret keys can be generated at the Group level and can be shared across all the tenants that are a part of the same group. That means you can pass the same Client ID & Secret key to all the tenants (IDs) that are a part of the group. - Group 1: Tenant 1, Tenant 2, Tenant 15, Tenant 50: Connecting to App1: Will share the same Client ID (X1) and Secret key (Y1) - Group 2: Tenant 1, Tenant 2, Tenant 25, Tenant 40: Connecting to App 2: Will share the same Client ID (X2) and Secret key (Y2) ## Generate the multi-tenant Client ID & Secret key pair through Enterprise Hub ### Prerequisites 1. Make sure a developer creates the App through the [developer portal](https://developer.servicetitan.io/). 2. Log in to **My Apps**. 3. Contact your CSM to get your Enterprise Hub Network ID. When your network is created in the Enterprise hub, a network ID will be generated. ![Form for creating a new app with required fields and organization details.](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/manage-api-credentials-through-enterprise-hub-image-1uwa0a52.png?sv=2026-02-06&spr=https&st=2026-10-31T01%3A36%3A10Z&se=2026-10-31T02%3A36%3A10Z&sr=c&sp=r&sig=3tLgmMzBj%2FIREmtEWhiyEgU5OFIBGvNwscCPsaYP%2FUA%3D) ## Grant access to API and Integrations To grant access to API and Integrations for a role: 1. In Enterprise Hub, click **User Management**. ![Overview of User Management module for managing user permissions and access.](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/manage-api-credentials-through-enterprise-hub-image-gu6blqdg.png?sv=2026-02-06&spr=https&st=2026-10-31T01%3A36%3A10Z&se=2026-10-31T02%3A36%3A10Z&sr=c&sp=r&sig=3tLgmMzBj%2FIREmtEWhiyEgU5OFIBGvNwscCPsaYP%2FUA%3D) 2. Select **Roles. ![User management interface displaying roles and their descriptions for permissions assignment.](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/manage-api-credentials-through-enterprise-hub-image-sqzf4xnn.png?sv=2026-02-06&spr=https&st=2026-10-31T01%3A36%3A10Z&se=2026-10-31T02%3A36%3A10Z&sr=c&sp=r&sig=3tLgmMzBj%2FIREmtEWhiyEgU5OFIBGvNwscCPsaYP%2FUA%3D)** 3. In the *EnterpriseHub permissions* tab, enable the **View** permission for *API & Integrations*. 4. Either [create a new user role](/construction/docs/create-and-edit-user-roles-in-enterprise-hub-1#create-user-roles) or edit an [existing user role](/construction/docs/create-and-edit-user-roles-in-enterprise-hub-1#edit-user-roles). 5. In the *EnterpriseHub permissions* tab, enable the **View** permission for *API & Integrations*. ![User selects the 'View' permission in the API & Integrations settings interface.](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/manage-api-credentials-through-enterprise-hub-image-4vt95unf.png?sv=2026-02-06&spr=https&st=2026-10-31T01%3A36%3A10Z&se=2026-10-31T02%3A36%3A10Z&sr=c&sp=r&sig=3tLgmMzBj%2FIREmtEWhiyEgU5OFIBGvNwscCPsaYP%2FUA%3D) 6. Click **Save Changes**. Users assigned this role can now see the *API & Integrations* module in EnterpriseHub. ## Step 1: Log in to your Enterprise Hub 1. Log in to your Enterprise Hub using your credentials. 2. Click the **API & Integrations** module. ![Overview of API and Integrations module for managing app credentials in Enterprise Hub.](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/manage-api-credentials-through-enterprise-hub-image-7jeu5dv2.png?sv=2026-02-06&spr=https&st=2026-10-31T01%3A36%3A10Z&se=2026-10-31T02%3A36%3A10Z&sr=c&sp=r&sig=3tLgmMzBj%2FIREmtEWhiyEgU5OFIBGvNwscCPsaYP%2FUA%3D) ## Step 2: Create a New Group 1. Click **Create New Group**. ![Interface for managing API Client IDs and creating new groups for integrations.](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/manage-api-credentials-through-enterprise-hub-image-em0rt699.png?sv=2026-02-06&spr=https&st=2026-10-31T01%3A36%3A10Z&se=2026-10-31T02%3A36%3A10Z&sr=c&sp=r&sig=3tLgmMzBj%2FIREmtEWhiyEgU5OFIBGvNwscCPsaYP%2FUA%3D) 2. Enter the name of your Group. 3. Click **Create Group. ![User interface for creating a new group in API and integrations section.](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/manage-api-credentials-through-enterprise-hub-image-ci7feauf.png?sv=2026-02-06&spr=https&st=2026-10-31T01%3A36%3A10Z&se=2026-10-31T02%3A36%3A10Z&sr=c&sp=r&sig=3tLgmMzBj%2FIREmtEWhiyEgU5OFIBGvNwscCPsaYP%2FUA%3D)** 4. Select all the tenants you want them to be a part of this Group. ![Selection interface for tenants with options to save or cancel changes.](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/manage-api-credentials-through-enterprise-hub-image-hbvbmtij.png?sv=2026-02-06&spr=https&st=2026-10-31T01%3A36%3A10Z&se=2026-10-31T02%3A36%3A10Z&sr=c&sp=r&sig=3tLgmMzBj%2FIREmtEWhiyEgU5OFIBGvNwscCPsaYP%2FUA%3D) 5. When finished, click **Save.** Your group is created and appears on the page. ![List of API groups with their IDs and actions for managing integrations.](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/manage-api-credentials-through-enterprise-hub-image-9r0zc41x.png?sv=2026-02-06&spr=https&st=2026-10-31T01%3A36%3A10Z&se=2026-10-31T02%3A36%3A10Z&sr=c&sp=r&sig=3tLgmMzBj%2FIREmtEWhiyEgU5OFIBGvNwscCPsaYP%2FUA%3D) 6. Click **More** ![](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/icon-more-vert.png?sv=2026-02-06&spr=https&st=2026-10-31T01%3A36%3A10Z&se=2026-10-31T02%3A36%3A10Z&sr=c&sp=r&sig=3tLgmMzBj%2FIREmtEWhiyEgU5OFIBGvNwscCPsaYP%2FUA%3D) to perform the following operations: 1. **Edit:** To add or remove tenants from the group 2. **Delete:** You can delete the group 3. **Connect New App:** You can subscribe to an App for the group and create a Client ID & Secret key at the group level. ![Menu options for managing groups including edit, delete, and connect new app features.](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/manage-api-credentials-through-enterprise-hub-image-n9u830u3.png?sv=2026-02-06&spr=https&st=2026-10-31T01%3A36%3A10Z&se=2026-10-31T02%3A36%3A10Z&sr=c&sp=r&sig=3tLgmMzBj%2FIREmtEWhiyEgU5OFIBGvNwscCPsaYP%2FUA%3D) ## Step 3: Connect New App to the Group On your newly created Group, click **More**![](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/icon-more-vert.png?sv=2026-02-06&spr=https&st=2026-10-31T01%3A36%3A10Z&se=2026-10-31T02%3A36%3A10Z&sr=c&sp=r&sig=3tLgmMzBj%2FIREmtEWhiyEgU5OFIBGvNwscCPsaYP%2FUA%3D)and select **Connect New App**. ![API integration interface showing options to create, edit, or connect new applications.](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/manage-api-credentials-through-enterprise-hub-image-dt1wrg9d.png?sv=2026-02-06&spr=https&st=2026-10-31T01%3A36%3A10Z&se=2026-10-31T02%3A36%3A10Z&sr=c&sp=r&sig=3tLgmMzBj%2FIREmtEWhiyEgU5OFIBGvNwscCPsaYP%2FUA%3D) ## Step 4: Select the App you want to connect 1. Choose the specific App you want to connect to the group and click **Connect New App.** 2. On the *Terms and Conditions* window that opens, read the terms and conditions and click **Accept**. 3. Select the App you want to connect to and click **Connect**. ![List of available apps with highlighted selection for flalaxy Business Units.](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/manage-api-credentials-through-enterprise-hub-image-ogh5h1ny.png?sv=2026-02-06&spr=https&st=2026-10-31T01%3A36%3A10Z&se=2026-10-31T02%3A36%3A10Z&sr=c&sp=r&sig=3tLgmMzBj%2FIREmtEWhiyEgU5OFIBGvNwscCPsaYP%2FUA%3D) 4. Click **Allow Access**. ![flalaxy Business Units requests access to your ServiceTitan account for reading and writing.](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/manage-api-credentials-through-enterprise-hub-image-5g5xrrki.png?sv=2026-02-06&spr=https&st=2026-10-31T01%3A36%3A10Z&se=2026-10-31T02%3A36%3A10Z&sr=c&sp=r&sig=3tLgmMzBj%2FIREmtEWhiyEgU5OFIBGvNwscCPsaYP%2FUA%3D)A message confirming that the App is connected appears. 5. Click **Generate**. ![Application details showing successful connection and client information for flalaxy Business Units.](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/manage-api-credentials-through-enterprise-hub-image-44vd8efi.png?sv=2026-02-06&spr=https&st=2026-10-31T01%3A36%3A10Z&se=2026-10-31T02%3A36%3A10Z&sr=c&sp=r&sig=3tLgmMzBj%2FIREmtEWhiyEgU5OFIBGvNwscCPsaYP%2FUA%3D) 6. On the window that opens, click **Yes, Continue**. The *Client Secret* opens. ![Client secret displayed with a note about its visibility and importance for security.](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/manage-api-credentials-through-enterprise-hub-image-co5aoavx.png?sv=2026-02-06&spr=https&st=2026-10-31T01%3A36%3A10Z&se=2026-10-31T02%3A36%3A10Z&sr=c&sp=r&sig=3tLgmMzBj%2FIREmtEWhiyEgU5OFIBGvNwscCPsaYP%2FUA%3D) ## Step 5: Embed the generated Client ID & Secret key into your App When you connect a new App to a Group, a new Client ID & Secret key is generated. Embed this newly generated Client ID & Secret key to your App. ## Step 6: Use the same Client ID & Secret key for all tenants in the Group Pass the same pair of Client ID & Secret keys each time you want to make an API call on behalf of any tenant that is part of the Group connecting to the App. ## FAQ --- ### #### Is there a way to get API access for Enterprise Hub integrations? No, there isn't. Enterprise Hub only allows to centrally manage API Keys. For more, see [Manage API credentials through Enterprise Hub](/construction/docs/manage-api-credentials-through-enterprise-hub). ## Want to learn more? - Visit ServiceTitan Academy and enroll in [Enterprise Hub Introduction](https://servicetitan.docebosaas.com/academy/learn/courses/263/enterprise-hub-basics/lessons/2313:173/enterprise-hub-introduction) - See [Enterprise Hub](/construction/docs/enterprise-hub-home)