Create an event

POST

1 from flatfile import Flatfile
2 from flatfile.events import Context
3 
4 client = Flatfile(
5     token="YOUR_TOKEN",
6 )
7 client.events.create(
8     topic="workbook:updated",
9     payload={"recordsAdded": 100},
10     domain="workbook",
11     context=Context(
12         account_id="us_acc_YOUR_ID",
13         actor_id="us_key_SOME_KEY",
14         environment_id="us_env_YOUR_ID",
15         space_id="us_sp_YOUR_ID",
16         workbook_id="us_wb_YOUR_ID",
17     ),
18 )

Play

200Example0

1 {
2   "data": {
3     "topic": "workbook:updated",
4     "context": {
5       "accountId": "us_acc_YOUR_ID",
6       "environmentId": "us_env_YOUR_ID",
7       "spaceId": "us_sp_YOUR_ID",
8       "workbookId": "us_wb_YOUR_ID",
9       "actorId": "us_key_SOME_KEY"
10     },
11     "createdAt": "2023-11-07T20:46:04.300Z",
12     "domain": "workbook",
13     "id": "us_evt_YOUR_ID",
14     "payload": {
15       "recordsAdded": 100
16     },
17     "callbackUrl": "",
18     "dataUrl": "",
19     "namespaces": [
20       "workbook"
21     ],
22     "origin": {
23       "id": "us_wb_YOUR_ID"
24     }
25   }
26 }

Request

This endpoint expects an object.

contextobjectRequired

The context of the event

domainenumRequired

The domain of the event

payloadmap from strings to anyRequired

topicenumRequired

The topic of the event

attributesobjectOptional

The attributes of the event

callbackUrlstringOptional

The callback url to acknowledge the event

dataUrlstringOptional

The url to retrieve the data associated with the event

deletedAtdatetimeOptional

Date the event was deleted

namespaceslist of stringsOptional

originobjectOptional

The origin resource of the event

targetstringOptional

Response

This endpoint returns an object.

dataobject

An event that tracks an activity within an environment

Create an event

Headers

Request

Response

Errors