Shiftbase

Availability

Core Standard Plus Pro Enterprise Flex PyAirbyte

Support Level

Marketplace

Connector Version

0.0.1 (last updated 2 days ago)

Data workers used

0.2 per sync (Learn more)

Definition ID

4d338322-bf11-4eeb-93b7-7aae9e92bcf7

This page contains the setup guide and reference information for the Shiftbase source connector.

Prerequisites

To set up the Shiftbase source connector, you'll need:

• A Shiftbase account with API access
• An Access Token generated from the Shiftbase App Center

Generating an Access Token

1. Log in to your Shiftbase account
2. Navigate to the App Center
3. Generate a new API Access Token
4. Copy and securely store the token - you'll need it for the connector configuration

Setup guide

Set up Shiftbase

For Airbyte Cloud

1. Log into your Airbyte Cloud account.
2. Click Sources and then click + New source.
3. On the Set up the source page, select Shiftbase from the Source type dropdown.
4. Enter a name for the Shiftbase connector.
5. Enter your Access Token from the Shiftbase App Center.
6. Enter your Start Date for historical data sync (format: YYYY-MM-DD).
7. Optionally, enter a Schedule Report End Date (format: YYYY-MM-DD) to set the end date for the Schedule Detail Report stream. Defaults to 1 month into the future if not provided.
8. Click Set up source.

For Airbyte Open Source

1. Navigate to the Airbyte Open Source dashboard.
2. Click Sources and then click + New source.
3. On the Set up the source page, select Shiftbase from the Source type dropdown.
4. Enter the name for the Shiftbase connector.
5. For Access Token, enter your Shiftbase API access token generated from the App Center.
6. For Start Date, enter the date in YYYY-MM-DD format. Data from this date onwards will be replicated.
7. Optionally, for Schedule Report End Date, enter a date in YYYY-MM-DD format to set the end date for the Schedule Detail Report stream. If not provided, it defaults to 1 month into the future from the current date.
8. Click Set up source.

Supported sync modes

The Shiftbase source connector supports the following sync modes:

• Full Refresh - Overwrite
• Full Refresh - Append
• Incremental - Append (for supported streams)
• Incremental - Append + Deduped (for supported streams)

Supported Streams

Stream	Sync Mode	Description
Departments	Full Refresh	Internal departments within the Shiftbase account
Employees	Full Refresh	List of employees (PII fields like name are excluded)
Absentees	Full Refresh, Incremental	Records of employee absences and leave
Employee Time Distribution	Full Refresh, Incremental	Distribution of worked and planned hours per employee
Availabilities	Full Refresh, Incremental	Employee availability slots and preferences
Shifts	Full Refresh	Scheduled work shifts and roster details
Users	Full Refresh	User account details (PII excluded, flattened structure)
Employees Report	Full Refresh	Employees report data
Timesheet Detail Report	Full Refresh, Incremental	Detailed timesheet report data
Schedule Detail Report	Full Refresh, Incremental	Detailed schedule report data

Performance considerations

The Shiftbase API has rate limiting in place. The connector handles rate limits automatically with exponential backoff. If you encounter rate limit issues, consider:

• Reducing the sync frequency
• Using incremental sync where available to minimize API calls

Data type map

Shiftbase Type	Airbyte Type
string	string
integer	integer
boolean	boolean
object	object
array	array
date	string
datetime	string

Limitations & Troubleshooting

Expand to review

Connector limitations

• The users stream is flattened and excludes PII (names, emails, phones, addresses) for privacy compliance
• The employees stream has the name field removed to minimize PII exposure
• Some streams (reports) make day-by-day API calls which may result in longer sync times for large date ranges

Troubleshooting

• Connection test fails: Verify your access token is valid and has not expired
• Empty streams: Ensure your Shiftbase account has data for the requested date range
• Rate limiting: The connector handles rate limits automatically, but extended syncs may take longer if limits are hit frequently

Reference

Config fields reference

Field

Type

Property name

string

access_token

string

start_date

string

schedule_report_end_date

Changelog

Expand to review

Version	Date	Pull Request	Subject
0.0.1	2026-08-27	72899	Initial release