---
title: "Api Process Analytics Events"
method: POST
path: "/v1/embed/analytics-events"
tags: ["embed v1"]
---

# Api Process Analytics Events

`POST /v1/embed/analytics-events`

## Request

- Base URL: `https://api.branchly.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.branchly.io/v1/embed/analytics-events`
- Auth: none declared

## Headers

- `x-api-key` string, nullable

## Request body

- AnalyticsEventsRawRequest
  - `data` AnalyticsEventData[], required
    - `url` string, uri, required: The URL where the event was triggered.
    - `metadata` object: Tracker payload for the event.
    - `event_name` string, required: The name of the custom event.
    - `source` string, nullable: Tracker the event came from, e.g. gtag, umami, ga4.
    - `timestamp` string, date-time, nullable: Client-side time the event fired.
  - `application_id` string, uuid, required
  - `session_id` string, uuid, required
  - `embed_type` 'chat' | 'search' | 'chat_widget' | 'search_interface' | 'voice' | 'api' | 'form', required

## Response `202`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/branchly/apis/branchly-io-api.md) · [All operations](https://skmtc.dev/branchly/apis/branchly-io-api/llms.txt) · [OpenAPI document](https://skmtc.dev/branchly/apis/branchly-io-api/revisions/9ffb024f8ec8?raw)