---
title: "Send an event as an authenticated user or agent"
method: POST
path: "/organizations/{organizationId}/events"
tags: ["Events"]
---

# Send an event as an authenticated user or agent

`POST /organizations/{organizationId}/events`

## Request

- Base URL: `https://api.chatdna.co/agent-push-kit/v1`
- URL: `https://api.chatdna.co/agent-push-kit/v1/organizations/{organizationId}/events`
- Auth: HTTP bearer

## Path parameters

- `organizationId` string, required

## Request body

- SendEventInput
  - `service` string, required
  - `serviceDisplayName` string
  - `type` string, required
  - `title` string, required
  - `body` string, required
  - `metadata` object
  - `externalId` string
  - `actionUrl` string, uri

## Response `201`

Event stored and push delivery attempted

- IngestionResult
  - `event` EventDetail, required
    - `id` string, required
    - `type` string, required
    - `title` string, required
    - `body` string, required
    - `externalId` string, nullable
    - `actionUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `service` ServiceSummary, required
      - `id` string, required
      - `name` string, required
      - `displayName` string, required
    - `serviceId` string, required
    - `metadata` object, nullable
  - `duplicate` boolean, required
  - `delivery` DeliverySummary, required
    - `sent` integer, required
    - `failed` integer, required
    - `suppressedUsers` integer, required
    - `eligibleDevices` integer, required

## Other responses

- `400`: Invalid request
- `401`: Missing, invalid, or revoked credentials
- `404`: The resource is absent or outside the current user's customer accounts

---

[API](https://skmtc.dev/agentpushkit/apis/agent-push-kit-api.md) · [All operations](https://skmtc.dev/agentpushkit/apis/agent-push-kit-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentpushkit/apis/agent-push-kit-api/revisions/f522c3cf50bf?raw)