---
title: "List incoming webhooks"
method: GET
path: "/incoming-webhooks"
tags: ["IncomingWebhooksReader"]
---

# List incoming webhooks

`GET /incoming-webhooks`

## Query parameters

- `limit` integer
- `cursor` string
- `tenantId` string
- `integrationId` string
- `connectionId` string
- `subscriptionId` string
- `status` 'success' | 'error'
- `externalAppId` string
- `from` string
- `to` string

## Response `200`

- IncomingWebhooksPaginatedResponseDto
  - `items` object[], required
    - `id` string, required
    - `name` string
    - `workspaceId` string, required
    - `customerId` string, required
    - `integrationId` string, required
    - `connectionId` string, required
    - `externalAppId` string
    - `subscriptionId` string, required
    - `userId` string, required
    - `uuid` string, required
    - `status` 'success' | 'error', required
    - `collectedEventIds` string[], required
    - `error` IncomingWebhooksPaginatedResponseDtoSchema0
      - `type` 'bad_request' | 'connection' | 'configuration' | 'dependency_error' | 'flow_run' | 'flow_instance_setup' | 'concurrency' | 'internal' | 'action_run' | 'action_instance_setup' | 'unit_run' | 'custom_code' | 'insufficient_credit' | 'openrouter_not_configured'
      - `key` string
      - `message` string, required
      - `data` object
      - `stack` object
      - `causedByError` IncomingWebhooksPaginatedResponseDtoSchema0 — recursive
      - `logs` object[]
    - `createdAt` string, required
    - `customer` object
      - `id` string, required
      - `name` string, required
      - `meta` object
      - `internalId` string, required
      - `fields` object
      - `credentials` object
      - `lastActiveAt` string
      - `isTest` boolean
      - `isBillable` boolean
      - `isActive` boolean
      - `aiCreditsRolling30DayLimit` number, nullable
      - `createdAt` string
      - `archivedAt` string
    - `connection` object
      - `id` string, required — Internal database ID of the element. Assigned by the API; unique per element.
      - `name` string, required
      - `userId` string, required
      - `tenantId` string
      - `type` 'connector' | 'mcp'
      - `key` string
      - `isTest` boolean
      - `connected` boolean
      - `disconnected` boolean — Use `connected` instead.
      - `isDefunct` boolean
      - `state` 'BUILDING' | 'CLIENT_ACTION_REQUIRED' | 'CONFIGURATION_ERROR' | 'SETUP_FAILED' | 'READY' | 'DISCONNECTING'
      - `errors` IncomingWebhooksPaginatedResponseDtoSchema0[]
        - `type` 'bad_request' | 'connection' | 'configuration' | 'dependency_error' | 'flow_run' | 'flow_instance_setup' | 'concurrency' | 'internal' | 'action_run' | 'action_instance_setup' | 'unit_run' | 'custom_code' | 'insufficient_credit' | 'openrouter_not_configured'
        - `key` string
        - `message` string, required
        - `data` object
        - `stack` object
        - `causedByError` IncomingWebhooksPaginatedResponseDtoSchema0 — recursive
        - `logs` object[]
      - `requestError` IncomingWebhooksPaginatedResponseDtoSchema0
        - `type` 'bad_request' | 'connection' | 'configuration' | 'dependency_error' | 'flow_run' | 'flow_instance_setup' | 'concurrency' | 'internal' | 'action_run' | 'action_instance_setup' | 'unit_run' | 'custom_code' | 'insufficient_credit' | 'openrouter_not_configured'
        - `key` string
        - `message` string, required
        - `data` object
        - `stack` object
        - `causedByError` IncomingWebhooksPaginatedResponseDtoSchema0 — recursive
        - `logs` object[]
      - `error` IncomingWebhooksPaginatedResponseDtoSchema0
        - `type` 'bad_request' | 'connection' | 'configuration' | 'dependency_error' | 'flow_run' | 'flow_instance_setup' | 'concurrency' | 'internal' | 'action_run' | 'action_instance_setup' | 'unit_run' | 'custom_code' | 'insufficient_credit' | 'openrouter_not_configured'
        - `key` string
        - `message` string, required
        - `data` object
        - `stack` object
        - `causedByError` IncomingWebhooksPaginatedResponseDtoSchema0 — recursive
        - `logs` object[]
      - `integrationId` string
      - `connectorId` string
      - `externalAppId` string
      - `connectorVersion` string
      - `authOptionKey` string
      - `createdAt` string, required
      - `updatedAt` string, required
      - `lastActiveAt` string
      - `nextCredentialsRefreshAt` string
      - `nextRetryTimestamp` string
      - `retryAttempts` number
      - `canTest` boolean
      - `canRefreshCredentials` boolean
      - `archivedAt` string
      - `isDeactivated` boolean
      - `meta` object
      - `buildingAgentSessionId` string — Session ID for building the element via intent-based endpoints (create/update with intent). Present when state is BUILDING.
      - `clientAction` object — Action the client must perform to advance this connection. Present if and only if state is CLIENT_ACTION_REQUIRED.
        - `type` 'connect' | 'provide-input', required
        - `description` string, required
        - `uiUrl` string
        - `agentInstructions` string
        - `handoffAgentInstructions` string
    - `subscription` object
      - `userId` string, required
      - `tenantId` string
      - `id` string, required
      - `name` string
      - `connectionId` string, required
      - `integrationId` string, required
      - `externalEventTypeId` string
      - `config` object
        - `type` 'data-record-created' | 'data-record-updated' | 'data-record-deleted' | 'connector-event', required
        - `dataSource` object
          - `key` object
          - `collectionKey` object
          - `collectionParameters` object
          - `udm` object
          - `pullUpdatesIntervalSeconds` number
          - `fullSyncIntervalSeconds` number
          - `path` object
          - `defaultPath` object
        - `eventKey` string
        - `eventParameters` object
      - `status` 'subscribed' | 'unsubscribed' | 'error'
      - `error` IncomingWebhooksPaginatedResponseDtoSchema0
        - `type` 'bad_request' | 'connection' | 'configuration' | 'dependency_error' | 'flow_run' | 'flow_instance_setup' | 'concurrency' | 'internal' | 'action_run' | 'action_instance_setup' | 'unit_run' | 'custom_code' | 'insufficient_credit' | 'openrouter_not_configured'
        - `key` string
        - `message` string, required
        - `data` object
        - `stack` object
        - `causedByError` IncomingWebhooksPaginatedResponseDtoSchema0 — recursive
        - `logs` object[]
      - `isRealTime` boolean
      - `requiresPull` boolean
      - `requiresFullSync` boolean
      - `createdAt` string
      - `archivedAt` string
      - `isDeactivated` boolean
      - `stateData` object
      - `nextPullEventsTimestamp` number
      - `pullUpdatesIntervalSeconds` number
      - `fullSyncIntervalSeconds` number
      - `nextRefreshTimestamp` number
      - `globalWebhookKey` string
      - `globalWebhookEventSelector` string
      - `incomingWebhookUri` string
      - `webhookUri` string
      - `user` object
        - `id` string, required
        - `name` string, required
        - `meta` object
        - `internalId` string, required
        - `fields` object
        - `credentials` object
        - `lastActiveAt` string
        - `isTest` boolean
        - `isBillable` boolean
        - `isActive` boolean
        - `aiCreditsRolling30DayLimit` number, nullable
        - `createdAt` string
        - `archivedAt` string
      - `connection` object
        - `id` string, required — Internal database ID of the element. Assigned by the API; unique per element.
        - `name` string, required
        - `userId` string, required
        - `tenantId` string
        - `type` 'connector' | 'mcp'
        - `key` string
        - `isTest` boolean
        - `connected` boolean
        - `disconnected` boolean — Use `connected` instead.
        - `isDefunct` boolean
        - `state` 'BUILDING' | 'CLIENT_ACTION_REQUIRED' | 'CONFIGURATION_ERROR' | 'SETUP_FAILED' | 'READY' | 'DISCONNECTING'
        - `errors` IncomingWebhooksPaginatedResponseDtoSchema0[]
          - `type` 'bad_request' | 'connection' | 'configuration' | 'dependency_error' | 'flow_run' | 'flow_instance_setup' | 'concurrency' | 'internal' | 'action_run' | 'action_instance_setup' | 'unit_run' | 'custom_code' | 'insufficient_credit' | 'openrouter_not_configured'
          - `key` string
          - `message` string, required
          - `data` object
          - `stack` object
          - `causedByError` IncomingWebhooksPaginatedResponseDtoSchema0 — recursive
          - `logs` object[]
        - `requestError` IncomingWebhooksPaginatedResponseDtoSchema0
          - `type` 'bad_request' | 'connection' | 'configuration' | 'dependency_error' | 'flow_run' | 'flow_instance_setup' | 'concurrency' | 'internal' | 'action_run' | 'action_instance_setup' | 'unit_run' | 'custom_code' | 'insufficient_credit' | 'openrouter_not_configured'
          - `key` string
          - `message` string, required
          - `data` object
          - `stack` object
          - `causedByError` IncomingWebhooksPaginatedResponseDtoSchema0 — recursive
          - `logs` object[]
        - `error` IncomingWebhooksPaginatedResponseDtoSchema0
          - `type` 'bad_request' | 'connection' | 'configuration' | 'dependency_error' | 'flow_run' | 'flow_instance_setup' | 'concurrency' | 'internal' | 'action_run' | 'action_instance_setup' | 'unit_run' | 'custom_code' | 'insufficient_credit' | 'openrouter_not_configured'
          - `key` string
          - `message` string, required
          - `data` object
          - `stack` object
          - `causedByError` IncomingWebhooksPaginatedResponseDtoSchema0 — recursive
          - `logs` object[]
        - `integrationId` string
        - `connectorId` string
        - `externalAppId` string
        - `connectorVersion` string
        - `authOptionKey` string
        - `createdAt` string, required
        - `updatedAt` string, required
        - `lastActiveAt` string
        - `nextCredentialsRefreshAt` string
        - `nextRetryTimestamp` string
        - `retryAttempts` number
        - `canTest` boolean
        - `canRefreshCredentials` boolean
        - `archivedAt` string
        - `isDeactivated` boolean
        - `meta` object
        - `buildingAgentSessionId` string — Session ID for building the element via intent-based endpoints (create/update with intent). Present when state is BUILDING.
        - `clientAction` object — Action the client must perform to advance this connection. Present if and only if state is CLIENT_ACTION_REQUIRED.
          - `type` 'connect' | 'provide-input', required
          - `description` string, required
          - `uiUrl` string
          - `agentInstructions` string
          - `handoffAgentInstructions` string
      - `integration` object
        - `id` string, required — Internal database ID of the element. Assigned by the API; unique per element.
        - `name` string, required — Display name. Always present in API responses (filled by API if not set on create).
        - `uuid` string — Stable unique identifier (UUID). Can be provided on create; otherwise generated. Must be unique across elements of this type.
        - `key` string — Stable key for referencing the element (e.g. in selectors). Unique per (parent, integration) scope. Generated from name if not provided on create.
        - `description` string — Optional human-readable description.
        - `meta` object — Optional key-value metadata.
        - `state` 'BUILDING' | 'CLIENT_ACTION_REQUIRED' | 'CONFIGURATION_ERROR' | 'SETUP_FAILED' | 'READY' | 'DISCONNECTING' — Current lifecycle or health state (e.g. READY, SETUP_FAILED, CONFIGURATION_ERROR, BUILDING). Set by the engine during setup and validation.
        - `errors` IncomingWebhooksPaginatedResponseDtoSchema0[] — Validation or setup errors when state is not READY.
          - `type` 'bad_request' | 'connection' | 'configuration' | 'dependency_error' | 'flow_run' | 'flow_instance_setup' | 'concurrency' | 'internal' | 'action_run' | 'action_instance_setup' | 'unit_run' | 'custom_code' | 'insufficient_credit' | 'openrouter_not_configured'
          - `key` string
          - `message` string, required
          - `data` object
          - `stack` object
          - `causedByError` IncomingWebhooksPaginatedResponseDtoSchema0 — recursive
          - `logs` object[]
        - `revision` string — Opaque revision token; changes on each update. Used for optimistic concurrency.
        - `createdAt` string — ISO date when the element was created.
        - `updatedAt` string — ISO date when the element was last updated.
        - `archivedAt` string
        - `isDeactivated` boolean
        - `isReadOnly` boolean — When true, the element cannot be modified (e.g. published package elements or elements from another workspace).
        - `logoUri` string, required
        - `connectorId` string
        - `connectorVersion` string
        - `oAuthCallbackUri` string
        - `parameters` object
        - `hasMissingParameters` boolean
        - `hasDocumentation` boolean
        - `hasOperations` boolean
        - `operationsCount` number
        - `hasData` boolean
        - `dataCollectionsCount` number
        - `hasEvents` boolean
        - `eventsCount` number
        - `hasGlobalWebhooks` boolean
        - `hasUdm` boolean
        - `isTest` boolean
        - `externalAppId` string
        - `authType` 'integration-app-token' | 'membrane-token' | 'oauth2' | 'oauth1' | 'client-credentials' | 'proxy'
        - `optionsConfig` object
  - `cursor` string

---

[API](https://skmtc.net/integration/apis/membrane-api.md) · [All operations](https://skmtc.net/integration/apis/membrane-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/integration/membrane-api/revisions/1db9c5a3d78c/schema)