Applied LabsDocs
Events

Create event

Record an event with an optional contact and/or metric emission. At least one of contact or metric must be provided.

POST/v2026-04/events/

Usage

Start from this cURL example and add filters as needed.

cURL
curl -X POST https://core.appliedlabs.ai/v2026-04/events/ \
  -H "Authorization: Bearer <api-token>" \
  -H "X-Shop-Id: 66e4c4d2-34e8-4f85-8f51-84b6ed7b5f10" \
  -H "Content-Type: application/json" \
  --data '{
  "contact": {
    "email": "string",
    "name": "string",
    "phone": "string",
    "remote_id": "string"
  },
  "description": "",
  "event_time": "2026-04-07T14:30:00Z",
  "metric": {
    "additional_properties": {
      "additionalProp1": "string"
    },
    "context_object_id": "66e4c4d2-34e8-4f85-8f51-84b6ed7b5f10",
    "context_object_type": "string",
    "deduping_key": "string",
    "metric_name": "string",
    "metric_object_id": "66e4c4d2-34e8-4f85-8f51-84b6ed7b5f10",
    "metric_object_type": "string",
    "value": 1
  },
  "name": "string"
}'

Authorizations

Authorizationstringheaderrequired

Send your Applied API key as Authorization: Bearer AL.... Create the key in the Applied dashboard and keep it on your server.

Header parameters

X-Shop-Idstring · uuidrequired

The shop whose data you want to read.

Body

required
contactallOf

Resolve or create a contact and add the event to their timeline.

contact.option1object
descriptionstring

Optional event description.

event_timestring · date-time

When the event occurred. Defaults to now.

metricallOf

Emit a ClickHouse metric event.

metric.option1object
namestringrequired

Event name, used as the activity title.

Generated Exampleapplication/json
{
  "contact": {
    "email": "string",
    "name": "string",
    "phone": "string",
    "remote_id": "string"
  },
  "description": "",
  "event_time": "2026-04-07T14:30:00Z",
  "metric": {
    "additional_properties": {
      "additionalProp1": "string"
    },
    "context_object_id": "66e4c4d2-34e8-4f85-8f51-84b6ed7b5f10",
    "context_object_type": "string",
    "deduping_key": "string",
    "metric_name": "string",
    "metric_object_id": "66e4c4d2-34e8-4f85-8f51-84b6ed7b5f10",
    "metric_object_type": "string",
    "value": 1
  },
  "name": "string"
}

Response

Event created successfully.

contactallOf

Resolved contact, if a contact was provided.

contact.option1object
{
  "contact": {
    "email": "string",
    "id": "66e4c4d2-34e8-4f85-8f51-84b6ed7b5f10",
    "phone": "string",
    "remote_id": "string"
  }
}