--- title: "BigChange Connector Setup Guide" slug: "bigchange-connector-setup-guide" updated: 2026-03-12T19:21:53Z published: 2026-03-12T19:21:53Z canonical: "docs.tuggerapp.com/bigchange-connector-setup-guide" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.tuggerapp.com/llms.txt > Use this file to discover all available pages before exploring further. # BigChange Connector Setup Guide Connect your BigChange account to Tugger and start pulling job management data into Power BI, Tableau, or Excel. Setup takes around 10 minutes. ## What you'll need - A **Tugger account** ([sign up free](https://tuggerapp.com/SignUp)) - A **BigChange account** with access to the **BigChange Developer Portal** - You'll need permission to create API keys in BigChange ## Step 1: Add the BigChange connector in Tugger 1. Log in to Tugger at [tuggerapp.com](https://tuggerapp.com) 2. Click **Add Connector** from the menu 3. Select **BigChange**, then click **Add Connector** You'll land on the BigChange Connector Settings page. ![Screenshot: Tugger BigChange connector settings page showing Connector Name, data start date, and API credentials fields](https://cdn.document360.io/915cfc9e-45d4-4924-af8d-4cea920ef985/Images/Documentation/big-change-tugger-settings.jpg) 1. Give your connector a name (e.g. "BigChange" or "BigChange - Operations") 2. Set your **Sync Historical Data From** date - choose how far back you want Tugger to pull data. The further back you go, the longer your first sync will take. Leave the API credentials fields blank for now - you'll fill those in after the next steps. ## Step 2: Find your Customer ID and create an API key in BigChange Tugger connects to BigChange using three credentials: your **Customer ID**, a **Client ID**, and a **Client Secret**. You'll find and create these in the BigChange Developer Portal. 1. Go to the [BigChange Developer Portal](https://developer.bigchange.com) and sign in 2. Navigate to **API Key Management** ![Screenshot: BigChange Developer Portal - API Key Management page showing the Customer ID in the page description and the Create new API Key button](https://cdn.document360.io/915cfc9e-45d4-4924-af8d-4cea920ef985/Images/Documentation/big-change-api-keys.jpg) Your **Customer ID** is shown at the top of this page in the line that reads *"You can create multiple API keys for your customer ID: XXXX"*. Make a note of it. 1. Click **Create new API Key** 2. Give your key a name (e.g. "Tugger") and optionally add a description 3. Under **Scopes**, select all of the following **read** permissions: ![Screenshot: Create API Key panel showing the full list of scopes](https://cdn.document360.io/915cfc9e-45d4-4924-af8d-4cea920ef985/Images/Documentation/big-changecreate--api-key.jpg) ![Screenshot: Scope selection with all read scopes ticked](https://cdn.document360.io/915cfc9e-45d4-4924-af8d-4cea920ef985/Images/Documentation/big-change-scope-selection.jpg) - contacts:persons:read - contacts:read - finance:read - jobs:read - notes:read - resources:read - stock:read - users:read - vehicles:read - webhooks:read - worksheets:read > **Important:** Only select the **:read** scopes listed above. Do not select any **:write** scopes - Tugger only needs read access to your data. 1. Click **Register** to create the key ## Step 3: Get your Client ID and Client Secret Once your API key is created, you need to generate credentials for it. 1. On the API Key Management page, click the **three-dot menu** next to your new key 2. Select **Create new credentials** ![Screenshot: API key list showing the three-dot context menu with Create new credentials option](https://cdn.document360.io/915cfc9e-45d4-4924-af8d-4cea920ef985/Images/Documentation/bigchange-create-new-credentials.jpg) 1. On the panel that appears, click **Create new credentials** 2. Your **Client ID** and **Client Secret** will be displayed ![Screenshot: Credentials panel showing the Client ID and Client Secret with copy buttons](https://cdn.document360.io/915cfc9e-45d4-4924-af8d-4cea920ef985/Images/Documentation/bigchange-credentials.jpg) > **Important:** Copy both values now using the copy buttons. The Client Secret will not be shown again once you leave this page. If you lose it, you can generate new credentials from the same menu, but you'll need to update them in Tugger too. ## Step 4: Enter your credentials in Tugger Return to the Tugger BigChange Connector Settings page you opened in Step 1. 1. Paste your **Customer ID** into the Customer Id field 2. Paste your **Client ID** into the Client Id field 3. Paste your **Client Secret** into the Client Secret field 4. Click **Save Settings** Tugger will verify the connection. If the credentials are accepted, you'll move on to the next stage. ## Step 5: Your first sync Once setup is complete, Tugger will begin pulling your BigChange data. You'll see the status on the Summary page. ![Screenshot: Tugger showing Awaiting First Tug status with connection confirmed](https://cdn.document360.io/915cfc9e-45d4-4924-af8d-4cea920ef985/Images/Documentation/bifchange-awaiting-first-tug.jpg) Depending on how far back your data start date goes, the first sync can take anywhere from a few minutes to longer. You can check progress on the Summary page - once it starts pulling data you'll see the status change to Tugging, with a row count updating as data comes in. ![Screenshot: Tugger Summary page showing Tugging status with BigChange connection confirmed and rows being pulled in](https://cdn.document360.io/915cfc9e-45d4-4924-af8d-4cea920ef985/Images/Documentation/bigchange-tugging.jpg) After that, Tugger syncs your data automatically every day at 08:00 UK time by default. You can change this - see [Managing Your Sync Schedule](/docs/managing-your-sync-schedule). **You'll receive an email** once your data is ready. The reporting options will then appear in Tugger and you can start building reports or using AI Insights. ## What's next? Once you've received the email confirming your data is ready: **Reporting** - [Connect Power BI Desktop to Tugger](/docs/connecting-power-bi-desktop-to-tugger) - build reports using your BigChange data - [Connect Tableau to Tugger](/docs/connecting-tableau-to-tugger) - [Export to Excel](/docs/connecting-excel-to-tugger) **AI Insights** - [What is Tugger AI Insights?](/docs/what-is-tugger-ai-insights) - ask questions about your BigChange data in plain English - [Connect Tugger to Claude](/docs/connecting-tugger-to-claude) | [ChatGPT](/docs/connecting-tugger-to-chatgpt)) **Manage your sync schedule** - [Managing Your Sync Schedule](/docs/managing-your-sync-schedule) - change when and how often Tugger pulls your data **Need help?** [Contact the Tugger team](https://tuggerapp.com/Contact) - we're happy to help you get set up.