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

Prev Next

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)
  • 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
  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

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

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

Screenshot: Scope selection with all read scopes ticked

  • 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

  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

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

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

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.

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

AI Insights

Manage your sync schedule

Need help? Contact the Tugger team - we're happy to help you get set up.