Docs
Node SDK

webhooks.deliveries.get

Read a webhook delivery in the authenticated project environment.

Import and client

TypeScript
import { RelayServer } from '@relayrtc/node'
 
const relay = new RelayServer({
  apiUrl: process.env.RELAYRTC_API_URL!,
  apiKey: process.env.RELAYRTC_SECRET_KEY!,
})

Requirements

A secret key with webhooks:read. The requested resource must belong to that key's project environment.

Parameters

OptionTypeDefault / requirementPurpose
endpointIdstringRequiredID returned when creating the webhook.
deliveryIdstringRequiredID of a delivery for this endpoint.
projectIdstringKey projectMust match the key's project.
environmentIdstringKey environmentMust match the key's environment.

Every method accepts RequestOptions as its final argument. Optional scope parameters go before RequestOptions. They cannot expand the key’s project or environment.

Example

TypeScript
const endpointId = 'webhook_example'
const deliveryId = 'delivery_example'
const result = await relay.webhooks.deliveries.get(endpointId, deliveryId)

Returns

Promise<WebhookDeliveryDetail>. Returns delivery fields, the complete event, original rawBody and attempts.

Behavior

Treat logged event data as sensitive application data. rawBody is the full original event JSON; the abbreviated example illustrates the field only.

REST equivalent

GET /v1/webhooks/{endpointId}/deliveries/{deliveryId}. Failures throw RelayApiError.