Create Event

This API endpoint creates a custom event in your workspace.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

⚠️ Enterprise plan required: This endpoint is only available to workspaces on an enterprise plan. Requests from workspaces on any other plan return.401 Unauthorized with the message "Creating audit log events requires an enterprise plan."

Notes:

Context

The context parameter is a JSON object of arbitrary key-value pairs that describe the event. Keys are strings; values can be strings, numbers, booleans, arrays, or nested objects. The object is stored as-is on the audit log entry and returned in the response.

For example, an event logging a testing session might include:

{
  "context": {
    "clientName": "ari",
    "topic": "testing"
  }
}

Event Type Prefix

The eventType value you submit is automatically prefixed withcustomEvent. in the stored event. For example, submitting eventType: "testing" results in a stored eventType of customEvent.testing.

Body Params
string
required

The event type you wish to log. Max 100 characters. The stored value is prefixed with customEvent. (see Notes above).

string
required

A human-readable description of the event. Max 500 characters.

string

The UUID of the user the event pertains to. Recommended for platform API callers so the event is attributed to the correct actor.

string

The UUID of the company the event pertains to. Required if actorId belongs to a client.

json
required

A JSON object of key-value pairs describing the event. See notes above for the expected shape.

Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json