Skip to main content

Runs

List runs

Returns every run on the account, newest first: QuickBooks actions and the account's other automations.

GEThttps://api.clickr.cloud/v2/events
  • No daily limit.
  • For assistants, the MCP tool get_event_status.

Request

curl https://api.clickr.cloud/v2/events \
  -H "Authorization: Bearer $CLICKR_API_KEY"

Response

200
{
  "events": [
    {
      "_id": "6729c1f04b7e3d0012a91e07",
      "type": "createProject",
      "status": "successful",
      "data": {
        "projectId": "4821",
        "name": "Henderson Residence Addition",
        "status": "In progress",
        "startDate": "11/10/2026",
        "error": false
      },
      "createdAt": "2026-11-04T09:12:44.512Z"
    }
  ]
}

The whole history comes back in one response; there are no filters or pages. To follow one action, use Get a run with its receipt.

You see the runs of the actions your access on the account includes.

Response

200, as JSON.

eventsarray of objects

The runs, newest first.

_idstring

The run's id: the receipt its action returned.

typestring

What the run does: createProject, updateProject, getProject, convertEstimateToInvoice or activateCustomer.

statusstring

Where the run is. Absent until a worker picks the run up, then processing, then successful, invalidInput (QuickBooks refused the input) or failed. queued appears when a run is retried.

One of queued, processing, successful, invalidInput, failed

dataobject

What the run did, once it has finished. Its fields depend on the type: see What a run returns.

createdAtstring

When the run was started, in ISO 8601.

Errors

JSON with an error and, on most, a message saying what to change. All errors

StatusErrorWhen
401No API Key providedThe Authorization header is missing.
401No account found for api key providedThe key isn't recognised: mistyped, revoked, or held by someone who has left the account.
401No integration found for accountThe account has no connector connected yet.
500Failed to list eventsThe runs couldn't be read. Try again.