List Tickets
syncro.list_tickets
ActionBusiness appsconnection required
Calls the Syncro MSP API with the connection's credentials.
Search or page the account's tickets, newest first.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- API key
- Providers
- Syncro MSP
- Secret shape
- the API token, or {"api_key": "…"}
- Config it needs
- subdomain, base_url
- Resolved by
- config.connection_id, else node.connection_id
Configuration
9 fields, none required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
query Free-text search across the ticket, the same one the Syncro UI runs. | string | No | — | — | printer offline |
status Return only tickets in this status; statuses are configured per account. | string | No | — | — | New |
customer_id Return only tickets belonging to this customer. | number | No | — | ≥ 1 | 1 |
contact_id Return only tickets whose contact is this one. | number | No | — | ≥ 1 | 1 |
user_id Return only tickets assigned to this Syncro user. | number | No | — | ≥ 1 | 1 |
number Return the ticket carrying this human-facing ticket number. | string | No | — | — | 2012 |
created_after Return only tickets created after this date, e.g. 2026-02-25. | string | No | — | — | 2026-02-25 |
since_updated_at Return only tickets updated after this date, e.g. 2026-02-25. | string | No | — | — | 2026-02-25 |
page Which page of results to return; Syncro pages every list endpoint. | number | No | — | ≥ 1 | 1 |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"contact_id": 1,
"created_after": "2026-02-25",
"customer_id": 1,
"number": "2012",
"page": 1,
"query": "printer offline",
"since_updated_at": "2026-02-25",
"status": "New",
"user_id": 1
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
tickets One entry per ticket on this page. | array | — |
tickets[].id The ticket id. | number | — |
tickets[].number The human-facing ticket number. | number | — |
tickets[].subject The ticket's subject line. | string | — |
tickets[].status The ticket's current status. | string | — |
tickets[].priority The ticket's priority, or null. | string | — |
tickets[].customer_id The customer the ticket belongs to. | number | — |
tickets[].customer_business_then_name The customer's display name. | string | — |
tickets[].created_at When the ticket was created. | string | — |
count How many tickets this page carried. | number | — |
meta Syncro's pagination block: page and total_pages. | object | — |
{
"count": 0,
"meta": {},
"tickets": [
{
"created_at": "",
"customer_business_then_name": "",
"customer_id": 0,
"id": 0,
"number": 0,
"priority": "",
"status": "",
"subject": ""
}
]
}Notes
- Syncro rate-limits the API to 180 requests per minute per IP address across the whole account.
See List Tickets run in a workflow.
In a technical demo we add the Syncro MSP connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.