investor.created

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

string

required

Unique per delivery.

string

required

Always "investor.created".

string (ISO 8601 UTC)

required

Timestamp the investor record was created.

object

required

See payload schema below.

`data` schema

string

required

The stable partner-side investor id you submitted.

string

required

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

string

required

Investor email.

string

required

Investor first name.

string

required

Investor last name.

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"
  }
}

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