Create event | SchematicHQ

X-Schematic-Api-Keystring

API Key authentication via header

This endpoint expects an object.

event_typeenumRequired

Either 'identify' or 'track'

Allowed values:

backfillboolean or nullOptional

Requires a secret API key, and trusted_client_clock. Import historical data without affecting billing.

bodyobjectOptional

idempotency_keystring or nullOptional<=255 characters

Optional client-supplied key. Duplicate events with the same key (scoped to the environment) are dropped for 24h.

sent_atdatetime or nullOptional

Optionally provide a timestamp at which the event was sent to Schematic

trusted_client_clockboolean or nullOptional

Requires a secret API key and sent_at. Use sent_at as the effective timestamp.

Created

dataobject

paramsobject

Input parameters

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

1	import { SchematicClient } from "@schematichq/schematic-typescript-node";
2
3	async function main() {
4	const client = new SchematicClient({
5	apiKey: "YOUR_API_KEY_HERE",
6	});
7	await client.events.createEvent({
8	eventType: "flag_check",
9	});
10	}
11	main();

1	{
2	"data": {
3	"captured_at": "2024-01-15T09:30:00Z",
4	"remote_ip": "203.0.113.42",
5	"user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/115.0.0.0 Safari/537.36",
6	"event_id": "evt_9f8b7c6d5a4e3f2b1c0d",
7	"remote_addr": "203.0.113.42"
8	},
9	"params": {}
10	}

1	import { SchematicClient } from "@schematichq/schematic-typescript-node";
2
3	async function main() {
4	const client = new SchematicClient({
5	apiKey: "YOUR_API_KEY_HERE",
6	});
7	await client.events.createEvent({
8	eventType: "flag_check",
9	});
10	}
11	main();

1	{
2	"data": {
3	"captured_at": "2024-01-15T09:30:00Z",
4	"remote_ip": "203.0.113.42",
5	"user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/115.0.0.0 Safari/537.36",
6	"event_id": "evt_9f8b7c6d5a4e3f2b1c0d",
7	"remote_addr": "203.0.113.42"
8	},
9	"params": {}
10	}