Retrieve meetings in a team space
This endpoint allows you to retrieve information about all meetings within a specific team space.
This endpoint allows you to retrieve information about all meetings within a specific team. This can be useful for displaying and managing meetings within the team or for automating processes that require meeting information. This endpoint will return only those meetings that meet the following criteria:
- The meeting is open – it has the status OPEN.
- It has a specified meeting start date – dateFrom.
- It has a specified meeting end date – dateTo.
- It has a specified meeting location – location.
Request
- Method: GET
- Path: /external/v0/zapier/webhooks/teams/{teamId}/meetings
- Header:
- X-KEY: API key for authentication.
- Path variables:
- teamId(number): Unique team identifier.
Response
After successfully retrieving the meetings, you will receive response in JSON format containing the following information:
[
{
"name": "name of meeting",
"dateFrom": "2023-07-26T09:59:00Z",
"dateTo": "2023-07-26T10:29:00Z",
"location": "office 05",
"id": 20850,
"team": {
"id": 20500454,
"name": "Testing team"
},
"meetingType": null,
"leader": {
"id": 1345550,
"fullName": "John Dark"
},
"recorder": {
"id": 1345550,
"fullName": "John Dark"
},
"owner": {
"id": 1345550,
"fullName": "John Dark"
},
"tags": {},
"state": "OPEN",
"phase": null,
"deleted": false,
"section": null,
"sectionId": null,
"conferenceUrl": "DEFAULT_CONFERENCE_SERVICE",
"sortOrder": 16431.0,
"objective": "
sdfsdfsd
","modificationState": "NO_MODIFICATION",
"createdAt": "2023-07-20T09:57:34.345Z",
"summary": null,
"ownerInfo": null,
"tenant": 409656,
"lastModified": "2023-07-20T09:59:52.505Z",
"deletedAt": null,
"attendees": [
{
"firstName": "Jane",
"lastName": "Blue",
"phoneNumberHome": null,
"phoneNumberWork": null,
"emailAddressWork": "jane.blue@gmail.com",
"emailAddressHome": null,
"facebookUrl": null,
"linkedInUrl": null,
"externalId": null,
"position": null,
"id": 13454540,
"fullName": "Blue Jane",
"roles": [
"ADMIN"
],
"status": null,
"statusDateTo": null,
"role": "ADMIN",
"company": null,
"addressState": null,
"addressZip": null,
"addressCity": null,
"addressStreet": null,
"invitationEmailSended": true,
"invitationEmailSendedBy": "SYSTEM",
"invitationEmailSendedAt": "2023-03 17T08:58:07.381Z",
"tenant": 409,
"locale": "en",
"zapierApiKey": "1ff88582554-7dasdaa8-430e-bb77-6289e454954f",
"zapierActive": true
}
]
Description of attributes:
- name: The name of the meeting.
- dateFrom: The start date and time of the meeting.
- dateTo: The end date and time of the meeting.
- location: The location where the meeting will take place.
- id: The unique identifier of the meeting.
- team: Information about the team associated with the meeting:
- id: Team identifier.
- name: Team name.
- meetingType: The type of meeting.
- leader: Information about the person leading the meeting, including:
- id: Person's identifier.
- fullName: Person's full name.
- recorder: Information about the person recording the meeting, with the same attributes as the meeting leader.
- owner: Information about the person who is the owner (organizer) of the meeting, with the same attributes as the meeting leader.
- tags: An array that may contain tags or labels assigned to the meeting.
- state: The state of the meeting.
- phase: The phase of the meeting.
- deleted: Indicates whether the meeting is marked as deleted (false means it is not deleted).
- section: The section that can be assigned to the meeting.
- sectionId: The identifier of the section assigned to the meeting.
- conferenceUrl: URL for the conference service.
- sortOrder: The order of the meeting within a list.
- objective: The objective of the meeting, which contains HTML.
- modificationState: The modification state of the meeting.
- createdAt: The date and time of meeting creation.
- summary: A brief summary of the meeting.
- ownerInfo: Information about the owner of the meeting.
- tenant: The identifier of the tenant or organization associated with the meeting.
- lastModified: The date and time of the last modification of the meeting.
- deletedAt: The date when the meeting was marked as deleted.
- attendees: A list of meeting attendees:
- firstName: First name of the person.
- lastName: Last name of the person.
- phoneNumberHome: Home phone contact of the person.
- phoneNumberWork: Work phone contact of the person.
- emailAddressWork: Work email address of the person.
- emailAddressHome: Home email address of the person.
- facebookUrl: Link to the person's Facebook profile.
- linkedInUrl: Link to the person's LinkedIn profile.
- externalId: External identifier of the person.
- position: Person's position in a work context.
- id: Unique identifier of the person.
- fullName: Full name of the person.
- roles: The role that the person holds.
- status: Person's status.
- statusDateTo: Date until which the person's status is valid.
- role: Person's role.
- company: The name of the company where the person works.
- addressState: The state or country of the person's residence.
- addressZip: The postal or ZIP code of the person's residence.
- addressCity: The city of the person's residence.
- addressStreet: The street of the person's residence.
- invitationEmailSended: Information about whether an invitation has been sent to the person.
- invitationEmailSendedBy: Who sent the invitation to the person.
- invitationEmailSendedAt: Date and time when the invitation was sent to the person.
- tenant: The identifier of the tenant or organization associated with this person.
- locale: The person's language settings.
- zapierApiKey: API key for integration purposes.
- zapierActive: Integration status.