A new record from your own source

custom.record_received · Ready Your own sources, XX

What it is

Private: from accounts you connect, delivered only to you.

Example: New lead: Nordvik Solar AB (Gothenburg)
Typed payload, validated by its JSON Schema
Collected today from Your own sources (XX)

Each event names its exact source, a link to the record, the licence and the attribution in its provenance.

Example event, standard format

{
  "specversion": "1.0",
  "id": "evt_01M5EV0NM0W2YY72SKBJ4WXYR6",
  "type": "custom.record_received",
  "source": "/sources/examples/custom",
  "time": "2026-10-21T09:00:00Z",
  "observed_at": "2026-10-21T09:00:42Z",
  "dataschema": "https://schemas.worldsignals.dev/custom.record_received/1.json",
  "datacontenttype": "application/json",
  "visibility": "private",
  "tenant": "tnt_example",
  "country": "SE",
  "subject": {
    "kind": "company",
    "name": "Nordvik Solar AB",
    "ws_id": "ent_01M5EV0NM024AGB5BKM390M2H0"
  },
  "entities": [
    {
      "kind": "account",
      "role": "source",
      "name": "Leads API"
    }
  ],
  "title": "New lead: Nordvik Solar AB (Gothenburg)",
  "data": {
    "source_id": "src_5f0c3b9e2d7a4c1e8b6f0a9d3c2e1b7a",
    "source_name": "Leads API",
    "record_id": "lead_10422",
    "fields": {
      "company.name": "Nordvik Solar AB",
      "company.city": "Gothenburg",
      "score": 82,
      "stage": "new"
    }
  },
  "provenance": {
    "source_id": "example",
    "source_name": "Example data",
    "url": "https://example.com/worldsignals/custom.record_received",
    "licence": "Example only, not a real record",
    "method": "example"
  },
  "confidence": 0.95,
  "personal_data": true,
  "revision": 1,
  "tags": [
    "example"
  ]
}

Payload fields

What data holds in a a new record from your own source event, from its JSON Schema. Every event also has the fields of the standard envelope: id, time, subject, place, provenance and more.

Field	Type	Meaning
`data.source_id`	Text	The member's source (/api/sources/<id>).
`data.source_name`	Text	Source name
`data.record_id`	Text	The record's id at the source.
`data.fields`	Text	The values the source mapping keeps, by the path they came from: text, numbers, true or false, or null.

Missing something? Just ask: a source, a country or an event type we don’t collect yet. Every request is read, and the most asked for are built first.

Ask for it

Give your agents something to notice

Start on the free plan, no card, and pick these events. Company emails get in as they confirm; personal addresses join the waiting list, or skip it with a paid plan.

Get this event See the live stream