investor.created - Zest Public API

When fired

Emitted once per row that is successfully created by POST /v1/investors. Rows that hit failed or already_exists do not fire this event.

Envelope fields

eventId

string

required

Unique per delivery.

eventType

string

required

Always "investor.created".

occurredAt

string (ISO 8601 UTC)

required

Timestamp the investor record was created.

data

object

required

See payload schema below.

`data` schema

partnerInvestorId

string

required

The stable partner-side investor id you submitted.

zestPersonId

string

required

Zest’s canonical person id (e.g. psn_abc123).

string

required

Investor email.

firstName

string

required

Investor first name.

lastName

string

required

Investor last name.

kycManagedBy

string

required

Always "partner" for partner-managed onboarding.

Example

{
  "eventId": "wde_a23bc89df1e405bd",
  "eventType": "investor.created",
  "occurredAt": "2026-05-07T14:01:32.000Z",
  "data": {
    "partnerInvestorId": "acme-inv-7341",
    "zestPersonId": "psn_abc123",
    "email": "alice@example.com",
    "firstName": "Alice",
    "lastName": "Liddell",
    "kycManagedBy": "partner"
  }
}

spv_request.cancelled subscription.created

​When fired

​Envelope fields

​data schema

​Example

When fired

Envelope fields

`data` schema

Example