Watch for meetings created through Salesloft
After a meeting has been scheduled in the Salesloft app, information about it can be obtained via the List meetings endpoint. Filter out all unnecessary events by setting the status filter to pending.
Integration must periodically fetch this endpoint and create events listed there on a user's calendar.
After event is created on a user's calendar, integration developers should mark pending meeting as booked using Update a meeting endpoint, we also need original event id and icaluid to be passed in order to properly match events in a case of further updates.
After an event's status is set to booked, it will be synchronized across the app to appear in places like the CRM, Analytics, and Activity Feed.
GET /v2/meetings
Request:
- Headers:
- Authorization: Bearer <api_key>
- Url Params:
- status: pending
- include_meetings_settings: true
Response:
Use the data provided in the response, to create events on the user's calendar.
- Status: 200
- Body:
{
"metadata": {
"filtering": {
"status": "pending"
},
"paging": {
"per_page": 25,
"current_page": 1,
"next_page": null,
"prev_page": null
},
"sorting": {
"sort_by": "start_time",
"sort_direction": "DESC NULLS LAST"
}
},
"data": [
{
"id": 1,
"title": "Hello, partner!",
"start_time": "2022-09-17T17:00:00.000000Z",
"end_time": "2022-09-17T17:30:00.000000Z",
"calendar_id": "external_00000000-0000-0000-0000-000000000000",
"calendar_type": "external",
"meeting_type": null,
"recipient_name": "Michael Scott",
"recipient_email": "michael.scott@example.com",
"location": null,
"description": "<div style=\"font-family: Arial; font-size: 11pt; line-height: 16px;\" class=\"sales_loft_wrapper\">location --> </div>",
"event_id": null,
"account_id": 1,
"task_id": null,
"created_at": "2022-09-15T10:00:13.307797Z",
"updated_at": "2022-09-15T10:00:13.796876Z",
"guests": [
"michael.scott@example.com"
],
"crm_references": null,
"event_source": "internal",
"canceled_at": null,
"all_day": false,
"no_show": false,
"crm_custom_fields": null,
"strict_attribution": false,
"i_cal_uid": null,
"status": "pending",
"attendees": [],
"person": {
"_href": "https://api.salesloft.com/v2/people/1",
"id": 1
},
"cadence": null,
"step": null,
"booked_by_user": {
"_href": "https://api.salesloft.com/v2/users/00000000-0000-0000-0000-000000000000",
"id": "00000000-0000-0000-0000-000000000000"
},
"owned_by_meetings_settings": {
"email_address": "robert.dunder@example.com"
},
"booked_by_meetings_settings": {
"email_address": "robert.mifflin@example.com"
}
},
...
]
}
Tell us about the calendar event creation process after it's finished.
PUT /v2/meetings/1
Request:
- Headers:
- Authorization: Bearer <api_key>
- Url Params: No specific query parameters needed.
- Body:
{
"status": "booked",
"event_id": "88461900a644011a17251ddafe82ca669e67553a",
"i_cal_uid": "hniulchcxm@domain.example.com"
}
Response:
- Status: 200
- Body:
{
"data": {
"id": 1,
"event_id": "88461900a644011a17251ddafe82ca669e67553a",
"i_cal_uid": "hniulchcxm@domain.example.com",
"status": "booked",
...
}
}