List tickets with optional filters. Returns paginated results.

Get a single ticket by ID with full details

Create a new ticket. Requires customer_id and subject at minimum. Note: line_items cannot be added inline during creation -- use tickets_add_line_item after the ticket is created.

Update an existing ticket. Only provided fields will be changed.

DELETE a ticket permanently. This action cannot be undone. The user MUST confirm before executing this.

Get all comments on a ticket

Add a comment to a ticket. Three comment modes: (1) Email reply: hidden=false, do_not_email=false sends email to customer. (2) Public note: hidden=false, do_not_email=true is visible on portal/invoice but no email sent. (3) Private note: hidden=true, do_not_email=true is tech-only and invisible to customer. Note: subject is REQUIRED or the API returns 422.

Add a line item (product/service charge) to a ticket. Note: name and description are REQUIRED even when using product_id (unlike invoices/estimates which auto-fill from catalog).

Remove a line item from a ticket. The user MUST confirm before executing this.

Update a line item on a ticket

Add a timer entry to a ticket for time tracking. Note: start_at is REQUIRED (API returns 422 without it). duration_minutes auto-calculates end_time from start_at.

Update a timer entry on a ticket

Delete a timer entry from a ticket. The user MUST confirm.

Charge a timer entry on a ticket (convert to billable line item)

Attach a file to a ticket via URL

Delete an attachment from a ticket. The user MUST confirm.

Generate a printable PDF for a ticket

Get ticket system settings

List ticket comments across multiple tickets as a flat paginated feed (distinct from tickets_get_comments which is scoped to one ticket). Sorted by ticket_id ASC, created_at DESC. Scope via ticket_search_id, ticket_id, customer_id, contact_id, user_id, status, mine, or date filters. comment_created_after/before filter at the comment level; the other date filters operate on the parent ticket.

List Ticket Blueprints available for ticket creation (hidden ones are excluded). Returns id, name, role, and children_count for each blueprint.

Create tickets from a Blueprint -- spawns the parent ticket and any child tickets defined by the blueprint, all assigned to the given customer. Returns { ticket_id, child_ticket_ids }.

List customers with optional filters. Returns paginated results.

Get a single customer by ID with full details

Create a new customer. Note: phone and mobile fields auto-create entries in the phones sub-resource.

Update an existing customer. Only provided fields will be changed.

DELETE a customer permanently. The user MUST confirm before executing.

Get the most recently created customers

Autocomplete search for customers by name or business

List phone numbers for a customer

Add a phone number to a customer

Update a phone number for a customer

Delete a phone number from a customer. The user MUST confirm.

List customer assets with optional filters. Returns paginated results.

Get a single asset by ID with full details

List the assets linked to one contact, sorted by name. 50 per page.

Create a new customer asset. Note: asset_type_name must match an existing type in the account. Custom properties on create are IGNORED -- set them via assets_update after creation.

Update an existing asset. Use this to set asset properties (hdd, manufacturer, model, os, cpu_name, ram, last_boot) after creation, as properties on create are ignored. Pass policy_folder_id to move the asset to a same-customer policy folder (see policies_list_folders).

Get patch information for an asset (available OS/software patches)

Get the paginated list of software applications installed on an asset. Returns name, vendor, version, and installed_at (falls back to first-seen date when no explicit install date is recorded).

Get chat information for assets by IDs

List contacts with optional filters

Get a single contact by ID

Create a new contact for a customer

Update an existing contact

DELETE a contact permanently. The user MUST confirm.

List invoices with optional filters

Get a single invoice by ID

Create a new invoice. Note: line_items in the create body are IGNORED by the API -- add line items via invoices_add_line_item after creation.

Update an existing invoice

DELETE an invoice permanently. The user MUST confirm.

Get the ticket associated with an invoice

Generate a printable PDF for an invoice

Email an invoice to the customer

Publish a draft invoice so it becomes a normal invoice. Needs draft invoices turned on for the account (404 otherwise). Refunds cannot be drafts, so Syncro refuses to publish them.

Turn a published invoice back into a draft so it can be edited before re-publishing. Needs draft invoices turned on for the account (404 otherwise). Syncro refuses (422) if a payment has been applied, the invoice was posted to an accounting provider, or it is a refund.

Add a line item to an invoice. When using product_id, only product_id + quantity are needed -- the API auto-fills name, cost, and price from the product catalog.

Update a line item on an invoice

Delete a line item from an invoice. The user MUST confirm.

List estimates with optional filters

Get a single estimate by ID

Create a new estimate. Note: line_items array in the create body is IGNORED by the API -- add line items via estimates_add_line_item after creation.

Update an existing estimate

DELETE an estimate permanently. The user MUST confirm.

Generate a printable PDF for an estimate

Email an estimate to the customer

Convert an estimate to an invoice

Add a line item to an estimate. When using product_id, only product_id + quantity are needed -- the API auto-fills name, cost, and price from the product catalog.

Update a line item on an estimate

Delete a line item from an estimate. The user MUST confirm.

List appointments with optional date range filter

Get a single appointment by ID

Create a new appointment. When possible, link to a ticket via ticket_id -- this auto-populates the description with ticket details and the location from the customer address.

Update an existing appointment

DELETE an appointment. The user MUST confirm.

List appointment types

Get an appointment type by ID

Create a new appointment type. Note: location_type is REQUIRED (API returns 422 without it). Integer value where 0 = 'customer'.

Update an appointment type

DELETE an appointment type. The user MUST confirm.

List products/inventory items

Get a product by ID

Create a new product. Note: products have no DELETE endpoint -- use products_update with disabled=true instead. Custom properties on create may be ignored -- set via products_update after creation.

Update a product

Look up a product by barcode/UPC

List product categories

Add images to a product

Delete an image from a product. The user MUST confirm.

Update product quantity at a location

List serial numbers for a product

Create a serial number for a product

Update a product serial

Attach serial numbers to a line item

List SKUs for a product

Create a SKU for a product

Update a product SKU

DELETE a product SKU. The user MUST confirm.

List payments

Get a single payment by ID

Record a payment. Use apply_payments to distribute a payment across multiple invoices.

List available payment methods

List stored payment profiles for a customer

Get a payment profile by ID

Create a stored payment profile for a customer

Update a payment profile

Delete a payment profile. The user MUST confirm.

List leads/opportunities

Get a lead by ID

Create a new lead. Note: leads have no DELETE endpoint. To soft-delete, use leads_update with disabled=true.

Update an existing lead

List contracts

Get a contract by ID

Create a new contract. Note: there is no 'notes' field -- 'description' is the only text field. The activity/notes section in the UI is not API-accessible.

Update a contract. Note: there is no 'notes' field -- 'description' is the only text field. The activity/notes section in the UI is not API-accessible.

DELETE a contract (soft-delete -- GET returns null after deletion, not 404). The user MUST confirm.

List RMM alerts

Get an RMM alert by ID

Create an RMM alert. Note: formatted_output (not in swagger) populates the 'Details' field in the UI. description maps to the 'Type' field. Include properties with trigger and description keys to match real alert structure.

Mute an RMM alert. Requires mute_for parameter.

DELETE (soft-resolve) an RMM alert. Sets resolved=true -- the alert is still readable via GET after deletion. The user MUST confirm.

Run an RMM script on one asset, now or once at a later time. Recurring schedules are not allowed through the API. No API lists scripts, so get script_id from the script's page in Syncro. This runs code on a customer machine: the user MUST confirm.

List recurring invoice schedules

Get a schedule by ID

Create a recurring invoice schedule. Always create with paused=true to prevent auto-firing during setup. Note: invoice-side fields (invoice name, employee, template, billing terms, memo) are NOT settable via API.

Update a schedule

DELETE a schedule. The user MUST confirm.

Add a line item to a recurring invoice schedule. Needs name or product_id. Pricing is in cents (retail_cents, cost_cents) or dollars (price_retail, price_cost). recurring_type_id picks the line type, e.g. 4 bills a customer's assets by type and 9 bills the assets in a policy folder; the type-specific fields only apply to their type.

Remove a line item from a schedule. The user MUST confirm.

Update a line item on a schedule. Takes the same fields as scheduling_add_line_item; only the fields you send change.

List ticket timers across tickets. Filter by ticket, technician, timer state, customer, or derived billing status. Use status 'running' or 'paused' to find a timer to pause or stop.

Start a live timer on a ticket for the API token's technician (user_id cannot be set). If that technician already has a running or paused timer on the ticket, Syncro resumes and returns it instead of making a second one. Omit billable to use the account default. For logging past work, use tickets_add_timer instead.

Start a timer that has never run, or resume a paused one. Syncro returns 422 if the timer is already running or stopped.

Pause a running timer. Syncro returns 422 if the timer is not running.

Stop a running or paused timer. If the account has 'charge timers by default' turned on, this also adds the charge line item to the ticket; otherwise charge it afterwards with tickets_charge_timer (timer_entry_id = this timer's ID). Syncro returns 422 if the timer is already stopped.

Change whether a ticket timer is billable. To start, pause, or stop a timer use time_start_timer, time_pause_timer, or time_stop_timer; to change notes or duration use tickets_update_timer.

List employee time logs (clock in/out records)

Update a time log entry (clock in/out, lunch, notes)

Get the most recent time log entry for the current user

Global search across Syncro (tickets, customers, assets, invoices, etc.)

Get the currently authenticated user's profile

List all users/technicians

Get a user by ID

Get system settings

Get settings tabs configuration

Get printing settings

List vendors

Get a vendor by ID

Create a new vendor. Note: there is no delete endpoint for vendors.

Update a vendor

List wiki pages

Get a wiki page by ID

Create a wiki page

Update a wiki page

DELETE a wiki page. The user MUST confirm.

List customer portal users

Create a customer portal user. Always provide contact_id to associate a person/name -- without it the portal user shows as an anonymous email.

Update a portal user

DELETE a portal user. The user MUST confirm.

Send a portal invitation to a user

List canned ticket responses

Create a canned response

Update a canned response

DELETE a canned response. The user MUST confirm.

Get canned response settings

Look up caller information by phone number

Register a user device for push notifications

Get a user device by ID

Update a user device

List new ticket forms

Get a ticket form by ID

Submit/process a new ticket form

List worksheet results for a ticket

Get a worksheet result by ID

Create a worksheet result for a ticket. Note: worksheet_template_id is required and must reference an existing admin-configured template.

Update a worksheet result

DELETE a worksheet result. The user MUST confirm.

List purchase orders

Get a purchase order by ID

Create a purchase order

Update a purchase order. Only status, general_notes, shipping_cents, delivery_tracking, and vendor_id can be changed. Syncro rejects the 'Finished' status while any line item is still unreceived.

Attach a file (vendor quote, invoice, packing slip) to a purchase order. Give exactly one source: file_url (a direct download link; works everywhere), file_path (a file on this computer; local installs only), or file_base64 (only for tiny files you create yourself, like a short CSV, because the whole file must be written out). Allowed: JPEG, PNG, GIF, PDF, CSV, XLS, XLSX. Max 10 MB and 10 files per PO; the extension must match the real file type.

Receive a line item on a purchase order

Add a line item to a purchase order. Note: the product must have maintain_stock=true or the API returns 422.

List items (global item catalog)

List line items across invoices/tickets

Login with a one-time password code

List policy folders for a customer. customer_id is required. Returns paginated results with each folder's parent_id, partial_policy_id (policy attached at this folder), and effective_policy_id (inherited policy).

Get a single policy folder by ID with full details.

Create a new policy folder under an existing parent folder. customer_id, name, and parent_id are all required -- folders cannot be created at the root level (the root folder is auto-created per customer). Use policies_list_folders first to find the root or desired parent folder ID.

Update an existing policy folder. Use this to rename, re-parent, or attach/detach a partial policy. Set partial_policy_id to null to detach the policy at this folder; the effective_policy_id then inherits from the parent.

DELETE a policy folder permanently. The folder must not have child folders (422 otherwise). This action cannot be undone -- the user MUST confirm before executing this.