Skip to main content

@dialstack/sdk / server / WebhookEndpoint

Interface: WebhookEndpoint

Defined in: sdk/server/src/index.ts:332

A webhook endpoint receives event notifications. Endpoints are mode-scoped: an endpoint created with a live key (and livemode: true) only receives events from live accounts; one created with a test key only receives events from sandbox accounts. The signing secret is returned only when the endpoint is created.

Endpoints are platform-global by default (they receive every account's events for their mode). To manage a single account's scoped endpoints instead, set dialstackAccount (the DialStack-Account header) on the client or request; that account's events are then delivered to its scoped endpoints in addition to the platform-global ones.

Properties

created_at

TypeScript
created_at: string;

Defined in: sdk/server/src/index.ts:342


description

TypeScript
description: string | null;

Defined in: sdk/server/src/index.ts:339


enabled_events

TypeScript
enabled_events: string[];

Defined in: sdk/server/src/index.ts:337

Subscribed event types, or ["*"] for all events.


id

TypeScript
id: string;

Defined in: sdk/server/src/index.ts:333


livemode

TypeScript
livemode: boolean;

Defined in: sdk/server/src/index.ts:335


secret?

TypeScript
optional secret?: string;

Defined in: sdk/server/src/index.ts:341

Present only on the create response. Store it to verify signatures.


status

TypeScript
status: "disabled" | "enabled";

Defined in: sdk/server/src/index.ts:338


url

TypeScript
url: string;

Defined in: sdk/server/src/index.ts:334