Linking SafetyCulture as a source
This source is currently in alpha. The interface and available tables may change.
The SafetyCulture (formerly iAuditor) connector syncs your workplace operations data — inspections, audits, corrective actions, issues, assets, and more — into the PostHog data warehouse.
Creating a SafetyCulture API token
SafetyCulture uses Bearer token authentication with an API key. The key grants read access to your organization's data via the Data Feeds API.
- Log in to your SafetyCulture account.
- Navigate to your account settings and find the API section.
- Generate a new API key.
- Copy the key.
For more details, see SafetyCulture's API documentation.
Note: SafetyCulture API tokens expire after 30 days of inactivity. If your syncs start failing with authentication errors, generate a new token.
Linking SafetyCulture
- Go to the Data pipeline sources page in PostHog.
- Click + New source and then click Link next to SafetyCulture.
- Paste your SafetyCulture API key.
- Click Next, choose the tables you want to sync, and then click Import.
Once the sync completes, you can query your SafetyCulture data directly in PostHog.
Configuration
| Option | Type | Required |
|---|---|---|
API token | password | Yes |
Supported tables
| Table | Description | Sync method | Incremental field | Primary key |
|---|---|---|---|---|
inspections | An inspection (audit) conducted from a template, with its score, timings, and location. | Incremental, Full refresh | modified_at | — |
inspection_items | A single question/item answered within an inspection, with its response, score, and media. | Incremental, Full refresh | modified_at | — |
templates | An inspection template that inspections are conducted from. | Incremental, Full refresh | modified_at | — |
actions | A corrective action, optionally raised against an inspection item, with its priority, status, and assignment context. | Incremental, Full refresh | modified_at | — |
issues | An issue reported in SafetyCulture, with its category, priority, status, and linked inspection/site. | Full refresh | — | — |
assets | An asset tracked in SafetyCulture, with its type, custom fields, site, and state. | Full refresh | — | — |
users | A user in your SafetyCulture organization. | Full refresh | — | — |
groups | A user group in your SafetyCulture organization. | Full refresh | — | — |
sites | A site (location, area, region, state, or country) in your SafetyCulture organization. | Full refresh | — | — |
schedules | A recurring inspection schedule, with its recurrence pattern, template, and site. | Full refresh | — | — |
Sync modes
Four tables support incremental syncing using modified_at as the cursor — only new or updated records sync on each run:
inspectionsinspection_itemstemplatesactions
The remaining six tables use full refresh — all data reloads on each sync. The SafetyCulture Data Feeds API doesn't support server-side modified_after filtering for these endpoints.
Available tables
| Table | Description | Sync method |
|---|---|---|
inspections | Inspections (audits) conducted from templates, with scores, timings, and locations | Incremental |
inspection_items | Individual questions/items answered within inspections, with responses, scores, and media | Incremental |
templates | Inspection templates that inspections are conducted from | Incremental |
actions | Corrective actions raised against inspection items, with priority, status, and assignment context | Incremental |
issues | Issues reported in SafetyCulture, with category, priority, status, and linked inspection/site | Full refresh |
assets | Assets tracked in SafetyCulture, with type, custom fields, site, and state | Full refresh |
users | Users in your SafetyCulture organization | Full refresh |
groups | User groups in your SafetyCulture organization | Full refresh |
sites | Sites (locations, areas, regions, states, or countries) in your SafetyCulture organization | Full refresh |
schedules | Recurring inspection schedules, with recurrence patterns, templates, and sites | Full refresh |