Skip to main content
POST
/
force-sync
TypeScript
import { Kombo } from "@kombo-api/sdk";

const kombo = new Kombo({
  integration_id: "workday:HWUTwvyx2wLoSUHphiWVrp28",
  api_key: "<YOUR_BEARER_TOKEN_HERE>",
});

async function run() {
  const result = await kombo.general.triggerSync({});

  console.log(result);
}

run();
{
  "status": "success",
  "data": {
    "already_queued": false,
    "sync_id": "119ihtp91nA3dqRFiV67nXS6",
    "type": "DELTA"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.kombo.dev/llms.txt

Use this file to discover all available pages before exploring further.

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).

Authorizations

​
Authorization
string
header
required

Create an API key on the Secrets page in the Kombo dashboard.

Headers

​
X-Integration-Id
string
required

ID of the integration you want to interact with.

Body

application/json

POST /force-sync Request body

​
type
enum<string>
default:FULL

The type of the triggered sync.

Available options:
FULL,
DELTA

Response

POST /force-sync Positive response

​
status
string
required
Allowed value: "success"
​
data
object
required
Example:
{
  "already_queued": false,
  "sync_id": "119ihtp91nA3dqRFiV67nXS6",
  "type": "DELTA"
}