---
title: "Sync ackDB Segment to Floq"
method: POST
path: "/api/v1/ackdb/segments/{segment_id}/sync"
tags: ["ackDB"]
---

# Sync ackDB Segment to Floq

`POST /api/v1/ackdb/segments/{segment_id}/sync`

## Request

- Base URL: `http://localhost:3009`
- URL: `http://localhost:3009/api/v1/ackdb/segments/{segment_id}/sync`
- Auth: HTTP bearer

Create a durable sync from an ackDB segment into a published Floq workflow. Every enter, exit, and re-entry is appended as a new workflow row with `Segment Change` set to `added` or `removed`. `field_mapping` keys are public workflow input references from List Inputs; values are ackDB segment field names. Existing members are optional synthetic `added` events. By default rows are inserted without running the workflow.

## Path parameters

- `segment_id` string, required

## Request body

- AckdbCreateSyncBody
  - `workflow_id` string, uuid, required
  - `field_mapping` object, required: Map workflow input references to ackDB segment fields, e.g. `{ "input.linkedin_url": "linkedin_url" }`.
  - `push_existing` boolean: Deliver members already in the segment. Defaults to false.
  - `run` 'all' | 'none': Run the workflow on delivered rows, or insert them without running. Defaults to none.
  - `reentry_mode` 'suppress' | 'repush': Deprecated for new event-ledger syncs, which always append re-entry as an added event.

## Response `201`

Default Response

- object
  - `status` integer, required
  - `data` object, required
    - `sync_id` string, required
    - `connection_id` string, required
    - `segment_id` string, required
    - `workflow_id` string, uuid, required
    - `entity_kind` 'company' | 'contact' | 'person', required
    - `state` 'seeding' | 'active' | 'paused' | 'pending_confirmation', required
    - `reused_sync` boolean, required

## Other responses

- `400`: Default Response
- `401`: Default Response
- `403`: Default Response
- `404`: Default Response
- `409`: Default Response
- `422`: Default Response
- `429`: Default Response
- `502`: Default Response

---

[API](https://skmtc.dev/floqer/apis/floqer-public-api.md) - [All operations](https://skmtc.dev/floqer/apis/floqer-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/floqer/apis/floqer-public-api/revisions/fce50dc07b20?raw)