GET /events
Gets events that are occurring in your Smartsheet organization account. Examples of events are creation, update, load, and delete of sheets, reports, dashboards, attachments, users, etc.
Each event type has a distinct combination of objectType and action. Many event types have additional information returned under an additionalDetails object. See the Event Reporting reference documentation for a complete list of all currently supported events, including their respective objectType, action, and additionalDetails properties.
Servers
- https://api.smartsheet.com/2.0
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
Accept-Encoding |
String | No |
Strongly recommended to make sure payload is compressed. Must be set to one of the following values:
Possible values:
|
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
numericDates |
Boolean | No |
If true, dates are accepted and returned in Unix epoch time (milliseconds since midnight on January 1, 1970 in UTC time). Default is false, which means ISO-8601 format. Default value: false |
streamPosition |
String | No |
Indicates next set of events to return. Use value of nextStreamPosition returned from the previous call. You must pass in a value for either since or streamPosition and never both. |
maxCount |
Integer | No |
Maximum number of events to return as response to this call. Must be between 1 through 10,000 (inclusive). Defaults to 1,000 if not specified. Default value: 1000 |
since |
String | No |
Starting time for events to return. Intended for use only at client startup or recovery. This is intended for backfilling data and not for fine-grained date-based queries. Therefore, resolution is limited to the nearest hour. Interpreted as ISO-8601 format, unless numericDates is specified (see details about numericDates below) You must pass in a value for either since or streamPosition and never both. |
managedPlanId |
Number | No |
The target managed plan for which to list events. Authorized if the caller is a system administrator on either the target managed plan or the main plan in EPM hierarchy. |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.