Webhooks

Get a webhook subscription

GET https://demo.notifuse.com/api/webhookSubscriptions.get

Retrieves a specific webhook subscription by ID.

Authorizations

Authorization string header required

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

Query Parameters

workspace_id string required

The ID of the workspace

  • Example: ws_1234567890
id string required

The ID of the webhook subscription

  • Example: whsub_a1b2c3d4e5f6

Response

200 Webhook subscription found object
subscription object

A webhook subscription that receives HTTP callbacks when events occur

Show child attributes
id string

Unique identifier for the subscription

  • Example: whsub_a1b2c3d4e5f6
name string

Human-readable name for the subscription

  • Example: Production Webhook
url string<uri>

The HTTPS URL to receive webhook events

  • Example: https://api.example.com/webhooks/notifuse
secret string

Secret key for signing webhook payloads (Standard Webhooks spec)

  • Example: whsec_a1b2c3d4e5f6g7h8i9j0
settings object

Settings for webhook subscription

Show child attributes
event_types string[]

List of event types this subscription is subscribed to

custom_event_filters object | null

Optional filters for custom_event.* event types

Show child attributes
goal_types string[] | null

Filter by goal type (e.g., purchase, subscription, lead)

event_names string[] | null

Filter by event name (e.g., orders/fulfilled, payment.succeeded)

list_ids string[]

Lists the list.* events are narrowed to. Absent or empty means every list.

segment_ids string[]

Segments the segment.* events are narrowed to. Absent or empty means every segment.

event_types string[]

List of event types this subscription is subscribed to (flattened from settings for convenience)

custom_event_filters object | null

Optional filters for custom_event.* event types (flattened from settings for convenience)

Show child attributes
goal_types string[] | null

Filter by goal type (e.g., purchase, subscription, lead)

event_names string[] | null

Filter by event name (e.g., orders/fulfilled, payment.succeeded)

list_ids string[]

Lists the list.* events are narrowed to (flattened from settings for convenience). Absent or empty means every list.

segment_ids string[]

Segments the segment.* events are narrowed to (flattened from settings for convenience). Absent or empty means every segment.

enabled boolean

Whether the subscription is currently active

  • Example: true
last_delivery_at string<date-time> | null

Timestamp of the last delivery attempt

  • Example: 2024-01-15T10:30:00Z
created_at string<date-time>

When the subscription was created

  • Example: 2024-01-01T00:00:00Z
updated_at string<date-time>

When the subscription was last updated

  • Example: 2024-01-15T10:30:00Z
400 Bad request - missing parameters object
error string required

Error message

401 Unauthorized - invalid or missing authentication token object
error string required

Error message

404 Webhook subscription not found object
error string required

Error message

500 Internal server error object
error string required

Error message