Add or Update Event
postaddOrUpdateEvent
post
[PlatformAddress]/api/1.0/event?action=addOrUpdateEvent
Add or update event details.
Request
Response
Request
Body Parameters
businessUnitId
optional
integer
Required when business unit defined in event's account
eventType
required
string
Required when adding an event. Value must be 12. The value cannot be changed for an existing event.
title
required
string
Required when adding an event. The title of the event. Max Length: 140
timezone
required
string
Required when adding an event. The timezone of the event. (Datatype = timestamp)
startDateTime
required
string
When adding an event. The start date & time of the event.
endDateTime
required
string
When adding an event. The end date & time of the event. The value must be on or after startDateTime. (Datatype = timestamp)
capacity
optional
integer
The maximum number of attendees who can register for the event. A value of 0 (zero) represents no limit.
budget
optional
number
A budget amount assigned to the event. (Datatype = float)
costCenterId
optional
integer
A cost center assigned to the event. The value is an identifier of a cost center in the account, which must be assignable to events.
primaryContactUserId
optional
integer
The primary contact user of the event. The value is an identifier of a user in the account.
Response
200: OK
{"success": true,"id": 98481,"code": "BAS4G248"}
{"eventType": 12,"title": "A New Event","timezone": "Australia/Sydney","startDateTime": "2018-03-05 03:00:00 UTC","endDateTime": "2018-03-05 06:00:00 UTC","capacity": 10,"budget": 150,"costCenterId": 834,"primaryContactUserId": 7821,"eventTypeIds": [56,57],"isAccommIncluded": false}
This action call accepts the parameters of an event and will;
1) Add a new event to the account
2) Update an existing event in the account when the id parameter is provided.
NOTE: This action call only supports “Record Event Details” type events (i.e. eventType value of 12).
Property | Description | Type |
success | Whether or not the action succeeded (i.e. the event as added or updated). | boolean |
id | The event’s unique identifier. The value will be null on failure. | integer |
code | The event’s unique code. The value will be null on failure. | string |