---
title: "Create event"
method: POST
path: "/events"
tags: ["events"]
---

# Create event

`POST /events`

Create a new event that can describe any action or information needed to be specifically logged, typically used to activity in rooms.

## Request body

- object — Create event properties
  - `log` string, required — Human readable log line to describe the context.
  - `context` object — Any object, typically JSON, used to describe to some information that needed to be logged.
  - `actionType` string — This is the type of the event
  - `roomId` integer — Room that this event relates to.
  - `botId` string — Bot that this event relates to.
  - `botDataId` string — Bot Data that this event relates to.
  - `botActionId` string — Bot Action that this event relates to.
  - `userId` string — User that this event relates to.
  - `owner` string — The name of the user to assign as the owner. Defaults to the user that created it

## Response `201`

Created event

- EventResponse — A response for information about a event
  - `id` string — The UUID of the specified event
  - `log` string — Human readable log line describing the event and its context it stores
  - `context` object — A object, typically JSON, that contains the information to describe an event
  - `actionType` string — This is the type of the event
  - `roomId` integer — The room ID in which the event deals with
  - `botId` string — The bot ID in which the event deals with
  - `botDataId` string — The bot data ID in which the event deals with
  - `botActionId` string — The bot action ID in which the event deals with
  - `userId` string — The user ID in which the event deals with

## Other responses

- `400` — Bad Request
- `401` — Authentication Error
- `403` — Forbidden
- `default` — Error

---

[API](https://skmtc.dev/salesforce/apis/refocus-api.md) · [All operations](https://skmtc.dev/salesforce/apis/refocus-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/salesforce/refocus-api/revisions/42c2153b047e/schema)