Applied LabsDocs
Signals

Create event

Record a metric event with an optional contact. Every accepted event creates or replays an Activity. Activities without a contact belong to the workspace rather than a contact timeline. Activity Event flows can match on the metric name, additional properties, and resolved contact fields.

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",
  "remote_id": "string",
  "remote_platform": "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 human-readable Activity description.

event_timestring · date-time

When the event occurred. Defaults to now.

metricallOfrequired

Emit a metric event for analytics and Activity Event flow triggers.

metric.option1object
namestringrequired

Human-readable event name used as the Activity title. The metric's metric_name remains the machine-readable signal type.

remote_idstring | null

Your system's durable ID for this event Activity.

remote_platformstring | null

The external platform or source namespace for remote_id.

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",
  "remote_id": "string",
  "remote_platform": "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"
  }
}