Skip to content

List an integration's events

API v2 is in public beta: endpoints and fields can change before general availability. See the changelog

GET/account/integrations/{id}/events

Costs 1 rate-limit point · Rate limits

What happened to one integration, newest first: connect links and key links issued, connects, disconnects (auto_disconnected when the provider revoked STOQ's access), keys set, cleared or refused, and settings changed (field names only). Each event says which surface did it: dashboard, quinn, mcp, api or system.

limit is 1 to 100 (default 20). Pass next_cursor back as before for the next page. Changes saved in the dashboard are recorded too.

Also searched asintegration historyklaviyo historywho disconnected klaviyointegration events

Path parameters

Query parameters

  • limitinteger

    Most events to return, from 1 to 100 (default 20).

    Default 20
  • beforeinteger

    Return only events older than this one; pass the next_cursor of the previous page.

Returns

  • eventsarray of objects
    Show 5 child attributesHide child attributes
    • idinteger
      Example: 1
    • kindstring
      Example: string
    • actor_surfacestring
      Example: string
    • detailobject
      Show 1 child attributeHide child attributes
      • fieldsarray of strings
    • created_atstring
      Example: 2026-01-15T09:30:00Z
  • next_cursorstring, nullable
    Example: string

Errors

404
not_found

The path is valid but nothing with that id exists in this store.

422
invalid_params

One or more fields failed the action's schema.

422
validation_failed

The request failed validation.

Any request can also fail with auth_invalid (401) or rate_limited (429).

Every error has the same shape: see Errors and the list of error codes.

GET/account/integrations/{id}/events
curl "https://app.stoqapp.com/api/v2/external/account/integrations/string/events" \
  -H "X-Auth-Token: $STOQ_API_KEY"
Response
{
  "events": [
    {
      "id": 1,
      "kind": "string",
      "actor_surface": "string",
      "detail": {
        "fields": [
          "string"
        ]
      },
      "created_at": "2026-01-15T09:30:00Z"
    }
  ],
  "next_cursor": "string"
}