---
title: "Trigger Booking Sync Endpoint"
method: POST
path: "/api/v1/bookings/sync"
tags: ["bookings"]
---

# Trigger Booking Sync Endpoint

`POST /api/v1/bookings/sync`

Queue a reservation import for this tenant.

MANAGE_SETTINGS, not the page's VIEW_REPORTS: this reaches out to the
customer's provider account, so it is an admin action rather than
something every viewer of /bookings can fire.

Returns immediately — progress is read from ``/bookings/sync-state``,
whose ``backfill_started_at``/``backfill_completed_at``/``last_error``
the job stamps per property.

## Request body

- TriggerBookingSyncRequest — ``since_months`` set = historical backfill; None = incremental sync.
  - `since_months` 1 | 3 | 12 | 24, nullable

## Response `200`

Successful Response

- TriggerBookingSyncResponse
  - `status` 'enqueued' | 'already_running', required
  - `job_id` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/getanana/apis/cleon-api.md) · [All operations](https://skmtc.dev/getanana/apis/cleon-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getanana/cleon-api/revisions/c0f54348e251/schema)