Skip to main content
PUT
/
webhooks
/
{webhookID}
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.update("8a1b2c3d-4e5f-4a6b-9c8d-1e2f3a4b5c6d", {
  url: "https://yourapp.com/webhooks/phosra",
  events: ["enforcement.completed"],
  active: true
});
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

webhookID
string<uuid>
required

Body

application/json
url
string
events
string[]
active
boolean

Response

Webhook updated

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.