v4

latestOpenAPI 3.0.02026-08-04109113304.5 KB
Events

Create a Custom Event

Create a Custom Event in a provided Project

post/projects/{project_id}/custom_events

Path parameters

project_idinteger required

The Project ID of the Project you want to create an Custom Event in

Request body

archivedboolean

Whether or not to archive this Event

category'add_to_cart' | 'save' | 'search' | 'share' | 'purchase' | 'convert' | 'sign_up' | 'subscribe' | 'other'
createdstring date-time

Creation date for this Event

descriptionstring

A description of this Event

event_type'custom'

The type of this Event

idinteger

The unique identifier of the Event

is_classicboolean

Whether or not this Event is a classic Event. If true, this Event is read-only

is_editableboolean

Whether or not this Event may be edited

keystring required

Unique string identifier for this Event within the Project

namestring

A human readable name for this Event. If unspecified, defaults to the key

project_idinteger

The ID of this Event's parent Project

Example request

{
  "key": "loaded_new_app",
  "name": "Loaded New App",
  "project_id": 1000
}

Response

Return the created Custom Event

archivedboolean

Whether or not to archive this Event

category'add_to_cart' | 'save' | 'search' | 'share' | 'purchase' | 'convert' | 'sign_up' | 'subscribe' | 'other'
createdstring date-time

Creation date for this Event

descriptionstring

A description of this Event

event_type'custom'

The type of this Event

idinteger

The unique identifier of the Event

is_classicboolean

Whether or not this Event is a classic Event. If true, this Event is read-only

is_editableboolean

Whether or not this Event may be edited

keystring required

Unique string identifier for this Event within the Project

namestring

A human readable name for this Event. If unspecified, defaults to the key

project_idinteger

The ID of this Event's parent Project

Example response

{
  "key": "loaded_new_app",
  "name": "Loaded New App",
  "project_id": 1000
}