Calendar & Accounting Sync API for Google Calendar, Outlook & QuickBooks | FieldCamp

The FieldCamp calendar sync API gives integrators a programmatic way to trigger Google Calendar, Outlook and QuickBooks syncs and to read incremental Google Calendar changes. Use it whenever a dispatcher action, a webhook from an upstream system, or a user-facing "Refresh now" button needs to push or pull data faster than the default polling cadence. This reference covers the four supported endpoints, their request and response shapes, and the error codes you need to handle in production code.

If you're new to the FieldCamp API, start with the API quickstart and Authentication before invoking integration endpoints. For the full API reference index and the in-app setup behind these connections, see Apps and integrations: all FieldCamp connections.

What the calendar sync API does

The integration sync endpoints are designed for one job: bring a connected third-party system into agreement with FieldCamp on demand. Four routes are available:

• POST /api/v1/integrations/google-calendar/sync — trigger a Google Calendar sync.
• GET /api/v1/integrations/google-calendar/sync — pull the incremental changes since the last successful run.
• GET /api/v1/integrations/google-calendar/status — read the current connection and sync state.
• POST /api/v1/integrations/outlook-calendar/sync — trigger an Outlook calendar sync.
• POST /api/v1/integrations/quickbooks/sync — trigger a bidirectional QuickBooks Online sync.

All of these endpoints assume the integration has already been connected in the FieldCamp web app under Integrations. If the connection is missing or the OAuth token has expired, FieldCamp returns the standard INTEGRATION_NOT_CONNECTED error described in Errors.

Authentication and headers

Every calendar sync API call uses the same bearer-token authentication as the rest of the FieldCamp API. Mutating endpoints (the POST triggers) should be sent with an idempotency key so retries are safe.

Trigger a Google Calendar sync

POST /api/v1/integrations/google-calendar/sync enqueues a sync between FieldCamp visits and the connected Google Calendar account. It is the API equivalent of clicking "Sync now" in the integration settings — the same control surfaced in Calendar sync and preferences.

Use this trigger after any action that changes a visit time or assignee — for example, a dispatcher reschedule, an AI Dispatcher suggestion being accepted, or a route optimization run. A typical request looks like:

POST /api/v1/integrations/google-calendar/sync HTTP/1.1
Host: api.fieldcamp.ai
Authorization: Bearer <api_key>

This trigger takes no request body and no parameters — there is no mode, and no Idempotency-Key is read (see Idempotency). The sync window comes from the token FieldCamp stores from the last run, so every call is effectively incremental.

It runs synchronously and returns the counts, not a job you poll:

{
  "success": true,
  "data": { "created": 4, "updated": 12, "deleted": 0, "errors": 0 }
}

Pull incremental Google Calendar changes

GET /api/v1/integrations/google-calendar/sync returns the events that have changed in Google Calendar since the last successful incremental sync. This is the right endpoint when you want to mirror Google-side changes into your own system without rebuilding the entire calendar.

GET /api/v1/integrations/google-calendar/sync?since=2026-05-29T13:00:00Z HTTP/1.1
Host: api.fieldcamp.ai
Authorization: Bearer <api_key>

The response is a paginated list of change records, each with an action (created, updated, or deleted), the FieldCamp visit ID where applicable, and the Google event ID. Use the returned next_cursor for any subsequent page. Combine the data you get back with the Visits API to keep your own scheduling view in lockstep with FieldCamp's calendar.

Read Google Calendar status

GET /api/v1/integrations/google-calendar/status tells you whether the connection is healthy and when the last sync ran. Call it before triggering a sync so you can short-circuit if the integration is disconnected.

{
  "success": true,
  "data": {
    "connected": true,
    "email": "dispatch@example.com",
    "lastSyncAt": "2026-05-29T14:05:11Z",
    "calendarId": "primary"
  }
}

Those four fields are the whole response. There is no scheduled-sync time, no active job id and no errors array — a sync either succeeds and returns its counts, or fails with an error envelope.

When connected is false, treat it the same as receiving INTEGRATION_NOT_CONNECTED on a trigger call — guide the user back into the integration settings to reconnect.

Trigger an Outlook calendar sync

POST /api/v1/integrations/outlook-calendar/sync mirrors the Google Calendar trigger pattern for Microsoft 365 / Outlook calendars. It is especially useful for service businesses whose field crews live in Outlook. After scheduling jobs through the Job Tray and dispatch workflow, call this endpoint to push fresh visit details to each technician's mailbox.

POST /api/v1/integrations/outlook-calendar/sync HTTP/1.1
Host: api.fieldcamp.ai
Authorization: Bearer <api_key>

Like the Google trigger it takes no body and no mode, runs synchronously, and returns counts rather than a job descriptor. An unconnected integration returns INTEGRATION_NOT_CONNECTED.

Trigger a QuickBooks sync

POST /api/v1/integrations/quickbooks/sync confirms your QuickBooks connection and acknowledges the request:

{ "success": true, "data": { "message": "QuickBooks sync triggered", "status": "queued" } }

POST /api/v1/integrations/quickbooks/sync HTTP/1.1
Host: api.fieldcamp.ai
Authorization: Bearer <api_key>

{
  "scope": "all"
}

Error handling

Sync endpoints use the standard FieldCamp error envelope documented in Errors. Two responses deserve special attention:

• INTEGRATION_NOT_CONNECTED — the requested integration is missing, never authorized, or its OAuth token has been revoked. Surface the user to the setup flow in Apps and integrations: all FieldCamp connections.
• 429 Too Many Requests — you have exceeded the per-key rate limit. See Rate limits. These endpoints do not return 409; a repeat trigger is accepted rather than rejected as a conflict.

Best practices for production

A few patterns that hold up well in real deployments:

• Trigger on user intent, not on a timer. Let scheduled jobs rely on FieldCamp's built-in cadence and reserve manual triggers for "Refresh now" buttons or webhook handlers — subscribe via webhook events to know when source data changed.
• Read the counts the trigger returns. The calendar triggers run synchronously and hand back created, updated, deleted and errors, so you do not need to poll — a non-zero errors is your signal to investigate. Use the status endpoint to check the connection is healthy before you trigger.
• Batch related changes. If your code adjusts ten visits in a row, trigger one calendar sync at the end instead of one per visit.
• Log the counts. Keeping a record of what each run created, updated and deleted makes drift easy to spot before users notice. There is no job id to log — these calls are not queued jobs.

Troubleshooting

If a sync returns an error or never completes, work through these checks before opening a support ticket. End users can follow a similar flow in Troubleshooting common issues and fixes.

1. Call the status endpoint. If connected is false, reconnect the integration first.
2. Check that the user who owns the OAuth grant still has access in Google, Microsoft, or Intuit.
3. Treat 409 as "a sync is already running" — wait, then poll status.
4. Read the errors array on the status response; codes there map to entries in Errors.
5. As a last resort, disconnect and reconnect to mint fresh OAuth tokens.

FAQs

Endpoints

These are the customer-callable integration endpoints. POST /api/v1/integrations/google-calendar/webhook also exists but is Google's push-notification receiver — it is unauthenticated by design and is not something your integration calls.

curl -X GET "https://example.com/api/v1/integrations/google-calendar/status"

{}

curl -X GET "https://example.com/api/v1/integrations/google-calendar/sync"

{}

curl -X POST "https://example.com/api/v1/integrations/google-calendar/sync"

{}

curl -X GET "https://example.com/api/v1/integrations/outlook-calendar/sync"

{}

curl -X POST "https://example.com/api/v1/integrations/outlook-calendar/sync"

{}

curl -X POST "https://example.com/api/v1/integrations/quickbooks/sync"

{}

Related articles

• Apps and integrations: all FieldCamp connections
• Connect Google Calendar and Outlook to FieldCamp
• Connect QuickBooks, Xero and Wave to FieldCamp
• Calendar sync and preferences
• API quickstart
• Authentication
• API keys resource
• Idempotency
• Rate limits
• Webhooks
• Webhook events catalog
• Errors
• Visits API
• API changelog