---
title: "List webhook connections for a project"
method: GET
path: "/v1/projects/{projectId}/webhooks/connections"
tags: ["Webhook Connections", "tier:standard"]
---

# List webhook connections for a project

`GET /v1/projects/{projectId}/webhooks/connections`

## Request

- Base URL: `https://api.particle.pro`
- URL: `https://api.particle.pro/v1/projects/{projectId}/webhooks/connections`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Returns the active (non-revoked) webhook connections for the project, whichever surface created them. Each connection reports its own surface so callers can label provenance. The signing secret is never returned — only its masked prefix.

## Path parameters

- `projectId` string, required: Project ID (base62-encoded).

## Response `200`

OK

- ListWebhookConnectionsResponseBody
  - `data` PlatformWebhookConnection[], nullable, required
    - `created_at` string, date-time, required
    - `created_by` Creator
      - `id` string, required: Creator's user ID
      - `name` string, required: Creator's display name
    - `id` string, required
    - `name` string: Optional human label for the connection.
    - `project_id` string, required
    - `revoked_at` string, date-time: Set when the connection was deleted/revoked; absent for active connections. A revoked connection stops delivering and is skipped by alerts that still reference it.
    - `secret_prefix` string, required: Masked signing-secret prefix for identification. The full secret is shown only at create/rotate time and cannot be retrieved afterward.
    - `surface` 'PLATFORM' | 'RADAR', required: Which Particle surface created this connection. Fixed at create time and inferred from the caller's authenticated surface context. Provenance only — an alert on either surface can deliver through it. Render it to show where the endpoint was registered.
    - `url` string, required: Destination URL that signed POSTs are delivered to.

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/particle/apis/particle-api.md) · [All operations](https://skmtc.dev/particle/apis/particle-api/llms.txt) · [OpenAPI document](https://skmtc.dev/particle/apis/particle-api/revisions/416ba82ab9d7?raw)