---
title: "Sync recent data now"
method: POST
path: "/integrations/{provider}/sync"
tags: ["Connections"]
---

# Sync recent data now

`POST /integrations/{provider}/sync`

## Request

- Base URL: `https://bodylab.lol/api/v1`
- URL: `https://bodylab.lol/api/v1/integrations/{provider}/sync`
- Auth: HTTP bearer

Waits up to 25 seconds for the service. History keeps importing in the background.

## Path parameters

- `provider` string, required: A connected service. Known values: garmin, oura, apple_health. Treat unknown values as "other".

## Headers

- `X-Client-Platform` string
- `X-Client-Version` string

## Response `200`

OK

- object
  - `status` string, required: How a sync run went (running while it's in progress). Known values: running, ok, partial, rate_limited, reauth_required, error. Treat unknown values as "other".
  - `activitiesAdded` integer, required
  - `wellnessDays` integer, required
  - `markersWritten` integer, required
  - `bodyScansWritten` integer, required: Body composition readings recorded or refreshed, which for a scale is the whole of what a sync did.
  - `error` string

## Other responses

- `401`: Error: UNAUTHORIZED.
- `409`: Error: NOT_CONNECTED, SYNC_IN_PROGRESS.
- `429`: Error: PROVIDER_COOLDOWN, SYNCED_RECENTLY.

---

[API](https://skmtc.dev/bodylab/apis/body-lab-api.md) · [All operations](https://skmtc.dev/bodylab/apis/body-lab-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bodylab/apis/body-lab-api/revisions/544c201eaf88?raw)