---
title: "Trigger sync"
method: POST
path: "/force-sync"
tags: ["General"]
---

# Trigger sync

`POST /force-sync`

Trigger a sync for a specific integration.

<Warning>Please note that it is **not** necessary nor recommended to call this endpoint periodically on your side. Kombo already performs periodic syncs for you and you should only trigger syncs yourself in special cases (like when a user clicks on a "Sync" button in your app).</Warning>

## Headers

- `X-Integration-Id` string, required

## Request body

- PostForceSyncRequestBody
  - `type` 'FULL' | 'DELTA' — The type of the triggered sync.

## Response `200`

POST /force-sync Positive response

- PostForceSyncPositiveResponse
  - `status` 'success', required
  - `data` object, required
    - `already_queued` boolean, required — We only allow 1 concurrent sync of the same type to be running or queued.
    - `sync_id` string, required — ID of the newly-created or already-queued-or-running sync.
    - `type` 'FULL' | 'DELTA', required — The type of the triggered sync. May differ from request, if the integration does not support delta syncs or if another sync is already running.

## Other responses

- `default` — The standard error response with just the platform error codes.

---

[API](https://skmtc.net/kombo/apis/kombo-api.md) · [All operations](https://skmtc.net/kombo/apis/kombo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kombo/kombo-api/revisions/1e45035b96d3/schema)