Skip to main content
GET
/
families
/
{familyID}
/
webhooks
SDK (@phosra/sdk)
import { PhosraClient } from "@phosra/sdk";

const phosra = new PhosraClient({
  baseUrl: "https://phosra-api-sandbox-production.up.railway.app/api/v1",
  accessToken: process.env.PHOSRA_API_KEY,
});

const result = await phosra.webhooks.list("f0000000-0000-4000-8000-0000000000f1");
console.log(result);
[
  {
    "id": "d41c8f2a-90b7-4e63-a15c-8f0e2b7d3946",
    "family_id": "fcdf4277-ba14-4732-8db5-0369b2c88d8b",
    "url": "https://api.rivera-safety.com/webhooks/phosra",
    "events": [
      "policy.updated",
      "enforcement.completed"
    ],
    "active": true,
    "created_at": "2026-06-18T14:32:07Z",
    "updated_at": "2026-06-30T09:15:44Z"
  }
]

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

familyID
string<uuid>
required

Response

Webhook list

id
string<uuid>

Unique identifier for this resource.

family_id
string<uuid>

Identifier of the family this resource belongs to.

url
string

HTTPS endpoint that receives POSTed webhook events.

events
string[]

List of event types this webhook subscribes to.

active
boolean

Whether the webhook is currently active and receiving deliveries.

created_at
string<date-time>

RFC 3339 timestamp of when the resource was created.

updated_at
string<date-time>

RFC 3339 timestamp of the resource's most recent update.