Sync

Filoxenos connects with major channel managers (Smoobu, Guesty, Hostaway, etc.) to keep your booking data in sync. Use these endpoints to monitor and trigger synchronization manually.

GET/sync/status

Retrieves the current synchronization status of your connected accounts.

Scoperead

Example Response

json

{
  "last_sync_all": "2026-04-09T18:00:00Z",
  "connections": [
    {
      "provider": "Smoobu",
      "connected_at": "2026-01-10T11:00:00Z",
      "last_sync_success": "2026-04-09T18:00:00Z",
      "status": "ACTIVE",
      "error_message": null
    },
    {
      "provider": "Airbnb",
      "connected_at": "2026-02-15T14:30:00Z",
      "status": "REAUTH_REQUIRED",
      "error_message": "OAuth token expired"
    }
  ]
}

POST/sync/trigger

Triggers an immediate synchronization for all connected channel managers.

Scopewrite

Sync Cooldown

Sync triggers are rate-limited to **once every 5 minutes**. Requests made during the cooldown period will return a 429 Too Many Requests response.

Response Body

Parameter	Type	Description
`sync_job_id`	string	Unique identifier for the triggered sync job.
`estimated_duration`	string	Approximate time until completion.

Example Response

json

{
  "sync_job_id": "job_sync_998877",
  "status": "queued",
  "estimated_duration": "15s"
}

Asynchronous Execution

The sync process runs in the background. It is recommended to listen for the sync.completed webhook event to handle the results programmatically.