Skip to main content
Start a sync

Authorizations

Authorization
string
header
required

Personal API key sent as a bearer token, together with X-Organization-Id. The key must have at least the access level the endpoint requires (read, write or admin).

Headers

X-Organization-Id
string

The organization to act in. Required for personal API keys; list the organizations you can access with GET /v1/organizations.

Path Parameters

id
string<uuid>
required

Body

application/json
date_from
string

First invoice date to read, inclusive.

Pattern: ^\d{4}-\d{2}-\d{2}$
date_through
string

Last invoice date to read, inclusive.

Pattern: ^\d{4}-\d{2}-\d{2}$
scope
object

Omit to read the integration’s saved scope. When sent, it replaces the saved scope for this run: every dimension it leaves out reads everything instead of falling back to the saved value.

max_files
integer

Stop after this many new invoices.

Required range: x <= 100000

Response

The sync was admitted and is running.

id
string<uuid>
required

Also the workflow run id: progress, items and cancel use it.

integration_id
string<uuid>
required
trigger
enum<string>
required
Available options:
manual,
scheduled
mode
enum<string>
required

period reads a requested date range; incremental continues from the last sync.

Available options:
period,
incremental
period
object | null
required

Invoice dates read: from is inclusive, to is exclusive.

scope
object
required

The scope this run used, frozen when it started.

max_files
integer | null
required
status
enum<string>
required
Available options:
queued,
running,
completed,
failed,
cancelled
coverage
enum<string>
required

partial: the run ended without reading everything it was asked to (discovery stopped early, invoices were deferred, or it was cancelled). retryable says whether a retry can complete it.

Available options:
in_progress,
full,
partial
discovery
object
required

Finding the invoices to import; items then import them one by one.

items
object
required
invoices
object
required
retryable
boolean
required

POST …/retry would resume discovery or re-queue failed invoices.

retry_blocked_by
enum<string> | null
required
Available options:
superseded,
configuration_changed,
integration_disabled,
active_sync,
null
failure
object | null
required
created_by
object | null
required
created_at
string<date-time>
required
finished_at
string<date-time> | null
required
workflow_run_id
string<uuid>
required