List an integration's events
API v2 is in public beta: endpoints and fields can change before general availability. See the changelog
/account/integrations/{id}/eventsCosts 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
idstringRequiredThe integration, by the id
GET /account/integrationslists (klaviyo, postscript …).
Query parameters
limitintegerMost events to return, from 1 to 100 (default 20).
Default20beforeintegerReturn only events older than this one; pass the next_cursor of the previous page.
Returns
eventsarray of objectsShow 5 child attributesHide child attributes
idintegerExample:1kindstringExample:stringactor_surfacestringExample:stringdetailobjectShow 1 child attributeHide child attributes
fieldsarray of strings
created_atstringExample:2026-01-15T09:30:00Z
next_cursorstring, nullableExample:string
Errors
not_foundThe path is valid but nothing with that id exists in this store.
invalid_paramsOne or more fields failed the action's schema.
validation_failedThe 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.
curl "https://app.stoqapp.com/api/v2/external/account/integrations/string/events" \
-H "X-Auth-Token: $STOQ_API_KEY"const res = await fetch("https://app.stoqapp.com/api/v2/external/account/integrations/string/events", {
headers: {
"X-Auth-Token": process.env.STOQ_API_KEY,
},
});
const data = await res.json();import os
import requests
res = requests.get(
"https://app.stoqapp.com/api/v2/external/account/integrations/string/events",
headers={"X-Auth-Token": os.environ["STOQ_API_KEY"]},
)
data = res.json()require "net/http"
require "json"
uri = URI("https://app.stoqapp.com/api/v2/external/account/integrations/string/events")
req = Net::HTTP::Get.new(uri, "X-Auth-Token" => ENV["STOQ_API_KEY"])
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
data = JSON.parse(res.body){
"events": [
{
"id": 1,
"kind": "string",
"actor_surface": "string",
"detail": {
"fields": [
"string"
]
},
"created_at": "2026-01-15T09:30:00Z"
}
],
"next_cursor": "string"
}{
"errors": [
"Invalid API key"
],
"code": "auth_invalid",
"details": [
{
"code": "auth_invalid",
"message": "Invalid API key",
"path": null,
"value": null,
"expected": null
}
]
}{
"errors": [
"Offer not found"
],
"code": "not_found",
"details": [
{
"code": "not_found",
"message": "Offer not found",
"path": null,
"value": null,
"expected": null
}
]
}{
"errors": [
"name is required"
],
"code": "validation_failed",
"details": [
{
"code": "validation_failed",
"message": "name is required",
"path": null,
"value": null,
"expected": null
}
]
}{
"errors": [
"Rate limit exceeded"
],
"code": "rate_limited",
"details": [
{
"code": "rate_limited",
"message": "Rate limit exceeded",
"path": null,
"value": null,
"expected": null
}
]
}