geo.record

Sent the minute a record that one of your Geo alert rules matches is written.

POSTyour https addressevent: geo.record

Plan GEOPayload unversionedSigned HMAC-SHA256Schema geo.record.schema.json

This event serves

Plan: GEO. Free to read, no account. Geo alerts, the API and Team are Geo's own plans: Geo plans. Pricing. Turn it on: Account, Geo, Webhooks: an endpoint; Account, Geo, Alerts: a rule with Webhooks ticked.

When it is sent

To every endpoint of the account, for every record a rule with Webhooks ticked matches.

Payload

Field	Meaning	Unit
event"geo.record"	`geo.record`.
sent_utcstring	When it was sent, ISO 8601 UTC.
recordobject	The record, with the fields of `GET /v1/items`.

Delivery


Answer	Any 2xx within 10 seconds. Redirects are not followed.
Retries	One attempt; a failed delivery can be retried by hand from the account page.
Switched off	Not switched off.
Volume	Up to 600 records an hour per account.
Test	`event: "geo.test"`, from Test beside the endpoint
Log	Every delivery's status and time on the account page, with a retry button.

Verify every request before reading it: Webhooks: verify the signature.

geo.test

Request we send

POST https://your.server/firmtape
Content-Type: application/json
X-FirmTape-Webhook-Id: evt_3f9a0c6e21d4b7a8e5f10c2d
X-FirmTape-Signature: t=1760034725,v1=<hex>

Body

{
  "event": "geo.record",
  "sent_utc": "2026-09-17T13:02:12Z",
  "record": {
    "uid": "8f1c2a90d4b7e613",
    "feed": "faa_tfr",
    "sector": "air",
    "severity": 2,
    "title": "Temporary flight restriction",
    "url": "https://example.org/notice"
  }
}

Verify

const crypto = require("node:crypto");
function verifyGeo(rawBody, header, secret) {
  const { t, v1 } = Object.fromEntries(String(header).split(",").map((p) => p.split("=")));
  if (!t || Math.abs(Date.now() / 1000 - Number(t)) > 300) return false;
  const mac = crypto.createHmac("sha256", secret).update(`${t}.${rawBody}`).digest("hex");
  return Boolean(v1) && mac.length === v1.length && crypto.timingSafeEqual(Buffer.from(mac), Buffer.from(v1));
}

Measurements of dealer positioning, never a forecast or a trade call. This page is built from FirmTape's public contract, the same files the OpenAPI document is built from; the tests hold them against the route code. Markdown: /docs/developers/geo/events/geo.record.md.

geo.record

When it is sent

Payload

Delivery

Related events