---
title: "Create a Synchronization"
method: POST
path: "/wordlift/v1/synchronizations"
tags: ["Synchronizations"]
---

# Create a Synchronization

`POST /wordlift/v1/synchronizations`

## Request

- Base URL: `https` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `https/wordlift/v1/synchronizations`
- Auth: none declared
- TypeScript: <https://skmtc.dev/insideout10/apis/wordlift-plugin/docs/wordlift/v1/synchronizations/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a new synchronization

## Response `200`

Synchronization created

- Synchronization
  - `created_at` string, required
  - `modified_at` string, required
  - `started_at` string
  - `stopped_at` string
  - `is_running` boolean, required
  - `total` integer, required
  - `offset` integer, required

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `409`: Another Synchronization is running

## Changes

- **2023-07-13** `18ae40c3d22f`: 1 info
  - endpoint added
- **2023-04-17** `f968547046e0`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/insideout10/apis/wordlift-plugin/changes/wordlift/v1/synchronizations/post.md)

---

[API](https://skmtc.dev/insideout10/apis/wordlift-plugin.md) - [All operations](https://skmtc.dev/insideout10/apis/wordlift-plugin/llms.txt) - [OpenAPI document](https://skmtc.dev/insideout10/apis/wordlift-plugin/revisions/00576e6d31eb?raw)