Installgraph

Start free

One webhook

GET/v1/webhooks/{id}

Returns one webhook's app, event types, filters, URL and status, free. The secret is never shown again.

View as MarkdownOpenAPI specAll docs for LLMs

Use it to check a single subscription's status; GET /v1/webhooks/{id}/deliveries shows what was sent.

Free. Scope events:read.

Request

curl "https://api.installgraph.com/v1/webhooks/6731b2e4c9a1f20d8e4b7c15" \
  -H "Authorization: Bearer $INSTALLGRAPH_API_KEY"

Path parameters

Name Type Required Description
id string Yes

Response

200. The example's stores are fictional.

{
  "data": {
    "id": "6731b2e4c9a1f20d8e4b7c15",
    "app": {
      "slug": "klaviyo",
      "name": "Klaviyo",
      "category": "email-sms"
    },
    "types": [
      "removed"
    ],
    "filters": {
      "country": "US"
    },
    "url": "https://example.com/hooks/installgraph",
    "description": null,
    "status": "active",
    "disabledReason": null,
    "creditsPerDelivery": 10,
    "createdAt": "2026-11-10T12:00:00.000Z",
    "lastDeliveredAt": "2026-11-12T04:21:07.000Z"
  },
  "meta": {
    "requestId": "6f1c2a9e-4b7d-4e2a-9c51-0d3b8e7f2a14",
    "creditsUsed": 0,
    "creditsCharged": 0,
    "creditsRemaining": 2480,
    "freeRepulls": 0
  }
}

Fields

Field Type Description
data.id string
data.app AppSummary
data.app.slug string Example: klaviyo.
data.app.name string The catalogue's name: our own for apps we curate, else the App Store listing title as written. Example: Klaviyo.
data.app.displayName string What a merchant calls the app, read from its keyword-padded App Store title ("Preorder, Back In Stock ‑ STOQ" is STOQ). A developer's listings that share a brand keep the words that tell them apart (Swym Wishlist Plus). Equal to name until derived. Example: Klaviyo.
data.app.category Category One of 28 values (see Data model).
data.app.kind string shopify-app: an app installed from Shopify. web: a website technology installed outside Shopify, by pasting its tag into the theme or through a tag manager (Google Tag Manager, Meta Pixel, Hotjar). A vendor with both has one entry of each (meta-pixel and meta-facebook-instagram-app). One of shopify-app, web.
data.types string[] One of installed, removed.
data.filters object The company filters it was created with.
data.filters.country string
data.filters.region string
data.filters.industry string
data.filters.aov string
data.url string
data.description string | null
data.status string disabled after 3 deliveries in a row failed every retry; create a new one. One of active, disabled.
data.disabledReason string | null
data.creditsPerDelivery integer Example: 10.
data.createdAt string (date-time)
data.lastDeliveredAt string (date-time) | null

Every keyed response also carries meta (requestId, creditsUsed, creditsRemaining, freeRepulls) and the X-Credits-* and X-RateLimit-* headers. See Credits and Rate limits.

Errors

Status Code Meaning What to do
404 not_found No such endpoint, app, or store (or not scanned yet). Check the slug or domain. Store 404s are free within the lookup-miss allowance.

All codes: Errors.