---
title: "ingestEvent"
method: POST
path: "/v1/app-events"
tags: ["App Analytics"]
---

# ingestEvent

`POST /v1/app-events`

Internal endpoint for services to submit app events for analytic purposes

## Request body

- union
  - AppEventData
    - `app_id` string, required — ID of the app configuration
    - `version` string, required — Version of the app configuration
    - `event_id` string
    - `component_id` string, required
    - `timestamp` string
    - `correlation_id` string
    - `event_type` 'ERROR' | 'WARNING' | 'INFO', required
    - `source` 'CUSTOM_JOURNEY_BLOCK' | 'PORTAL_EXTENSION' | 'CUSTOM_FLOW_ACTION' | 'ERP_INFORM_TOOLKIT', required — Type of app component
    - `actor` Actor, required
      - `org_id` string — Organization ID of the actor
      - `user_id` string — User ID of the actor
      - `type` 'user' | 'system', required — Type of the actor (e.g., user, system)
    - `details` object — Details about the event
  - BatchEventRequest
    - `events` AppEventData[], required
      - `app_id` string, required — ID of the app configuration
      - `version` string, required — Version of the app configuration
      - `event_id` string
      - `component_id` string, required
      - `timestamp` string
      - `correlation_id` string
      - `event_type` 'ERROR' | 'WARNING' | 'INFO', required
      - `source` 'CUSTOM_JOURNEY_BLOCK' | 'PORTAL_EXTENSION' | 'CUSTOM_FLOW_ACTION' | 'ERP_INFORM_TOOLKIT', required — Type of app component
      - `actor` Actor, required
        - `org_id` string — Organization ID of the actor
        - `user_id` string — User ID of the actor
        - `type` 'user' | 'system', required — Type of the actor (e.g., user, system)
      - `details` object — Details about the event

## Response `202`

Events accepted for processing

## Other responses

- `400` — Invalid event format

---

[API](https://skmtc.net/epilot/apis/app-api.md) · [All operations](https://skmtc.net/epilot/apis/app-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/epilot/app-api/revisions/03b93188c6d4/schema)