subscription.created

When fired

Emitted once per subscription successfully created by POST /v1/spvs/{spv_slug}/subscriptions. The subscription is in pending status and is ready to receive a signed form upload.

Envelope fields

string

required

Unique per delivery.

string

required

Always "subscription.created".

string (ISO 8601 UTC)

required

Timestamp the subscription was created.

object

required

See payload schema below.

`data` schema

string

required

Stable subscription identifier.

string

required

The SPV the subscription belongs to.

string

required

Zest person id of the investor.

string

Echoed from the request when supplied.

object

required

Investment amount as { "currency": "USD", "value": "50000.00" }.

Slug of the share class on this subscription.

string

required

Always "pending" for this event.

Example

{
  "eventId": "wde_91ee5c2a7f6304bd",
  "eventType": "subscription.created",
  "occurredAt": "2026-05-07T14:32:18.000Z",
  "data": {
    "subscriptionSlug": "sub_p9q8r7",
    "spvSlug": "veh_klm456",
    "personId": "psn_abc123",
    "partnerSubscriptionId": "acme-sub-9921",
    "lumpSum": { "currency": "USD", "value": "50000.00" },
    "shareClassSlug": "sc_classA",
    "status": "pending"
  }
}

Getting Started

Concepts

Webhooks

Reference

When fired

Envelope fields

`data` schema

Example

​When fired

​Envelope fields

​data schema

​Example

When fired

Envelope fields

`data` schema

Example