record.created

Fires once when a record is created, on any object. There is no per-object subscription: filter on objectId in your handler if you only care about deals.

Payload

{
  "id": "whd_3JAx8Qm2rL9pKd",
  "event": "record.created",
  "createdAt": "2026-09-11T14:18:54.201Z",
  "data": {
    "recordId": "rec_3Ab9xK2mQ7",
    "objectId": "obj_2Zc7pL",
    "record": {
      "name": "Ravenna Foods",
      "annual_value": 48000,
      "stage": ["opt_3Kd8sM"],
      "owner": ["user_5Nc1rT"]
    }
  }
}

string

required

The new record’s id. Always present: a payload without one is not sent at all.

string

The object the record belongs to. Omitted if the emitter did not carry it.

object

The record’s fields, keyed by property key. Omitted entirely when the emitter carried no field list, which is not the same as a record with no fields.

Reading the fields

Keys are property keys (annual_value), stable across renames. Values are the stored shape, so a select is ["opt_…"] and a relation is ["rec_…"]. See Payload format. A field whose property key cannot be resolved is dropped rather than included under an empty key, so record may be narrower than the record itself.

Unlike record.updated, the record object here does not carry an id key. The record’s id is recordId on the payload.

Worth knowing

Bulk creation does not fire this. Imports, job runs and other automated bulk writes are suppressed. See the catalog.
A form submission creates a record, and fires both this and form.submitted. If you act on both, deduplicate on recordId.
The payload is a snapshot at creation. Anything set afterwards arrives as record.updated.

Example

custral.on("record.created", async (event) => {
  const {recordId, objectId, record} = event.data;

  if (objectId !== process.env.DEALS_OBJECT_ID) return;

  await crm.upsertDeal({
    externalId: recordId,
    name: String(record?.name ?? "Untitled"),
    value: Number(record?.annual_value ?? 0),
  });
});

Getting started

Building a receiver

Event reference

Operations

Payload

Reading the fields

Worth knowing

Example

​Payload

​Reading the fields

​Worth knowing

​Example

Payload

Reading the fields

Worth knowing

Example