---
title: "List an integration's events"
description: "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 (f"
url: https://docs.stoqapp.com/v2-reference/account-integrations/list-an-integrations-events/
api: "API v2 reference"
method: GET
path: "/account/integrations/{id}/events"
---

# List an integration's events

`GET https://app.stoqapp.com/api/v2/external/account/integrations/{id}/events`

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.

**Note:** 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.

## Path parameters

- `id` (string, required): The integration, by the id [`GET /account/integrations`](https://docs.stoqapp.com/v2-reference/account-integrations/list-integrations/) lists (klaviyo, postscript …).

## Query parameters

- `limit` (integer): Most events to return, from 1 to 100 (default 20).
- `before` (integer): Return only events older than this one; pass the next_cursor of the previous page.

## Returns

- `events` (array of objects)
  - `id` (integer): e.g. `1`
  - `kind` (string): e.g. `string`
  - `actor_surface` (string): e.g. `string`
  - `detail` (object)
    - `fields` (array of strings)
  - `created_at` (string): e.g. `2026-01-15T09:30:00Z`
- `next_cursor` (string, nullable): e.g. `string`

Rate limit: this call costs 1 point ([rate limits](https://docs.stoqapp.com/docs/rate-limits/)).

## Example request

```sh
curl "https://app.stoqapp.com/api/v2/external/account/integrations/string/events" \
  -H "X-Auth-Token: $STOQ_API_KEY"
```

## 200

Success: the requested resource.

```json
{
  "events": [
    {
      "id": 1,
      "kind": "string",
      "actor_surface": "string",
      "detail": {
        "fields": [
          "string"
        ]
      },
      "created_at": "2026-01-15T09:30:00Z"
    }
  ],
  "next_cursor": "string"
}
```

## 401

Missing or invalid `X-Auth-Token`.

```json
{
  "errors": [
    "Invalid API key"
  ],
  "code": "auth_invalid",
  "details": [
    {
      "code": "auth_invalid",
      "message": "Invalid API key",
      "path": null,
      "value": null,
      "expected": null
    }
  ]
}
```

## 404

The resource does not exist for this shop, or the action path is not registered.

```json
{
  "errors": [
    "Offer not found"
  ],
  "code": "not_found",
  "details": [
    {
      "code": "not_found",
      "message": "Offer not found",
      "path": null,
      "value": null,
      "expected": null
    }
  ]
}
```

## 422

The request failed validation.

```json
{
  "errors": [
    "name is required"
  ],
  "code": "validation_failed",
  "details": [
    {
      "code": "validation_failed",
      "message": "name is required",
      "path": null,
      "value": null,
      "expected": null
    }
  ]
}
```

## 429

Rate limited: cost-weighted per token (read 1, write 2; 360 points / 60s). Check `Retry-After`.

```json
{
  "errors": [
    "Rate limit exceeded"
  ],
  "code": "rate_limited",
  "details": [
    {
      "code": "rate_limited",
      "message": "Rate limit exceeded",
      "path": null,
      "value": null,
      "expected": null
    }
  ]
}
```

