Skip to main content

@dialstack/sdk-dev / server/src / WebhookEndpoint

Interface: WebhookEndpoint

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

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:463


description​

TypeScript
description: string | null;

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


enabled_events​

TypeScript
enabled_events: string[];

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

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


id​

TypeScript
id: string;

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


livemode​

TypeScript
livemode: boolean;

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


secret?​

TypeScript
optional secret?: string;

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

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


status​

TypeScript
status: "disabled" | "enabled";

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


url​

TypeScript
url: string;

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