Creating a meeting

This endpoint allows you to automate the process of creating meetings in the Beenia Application through integration tools. You can use it to easily create meetings with defined parameters and ensure that your users have up-to-date information about their meetings.

Request

• Method: POST
• Path: /external/v0/zapier/webhooks/meetings
• Header:

• X-KEY: API key for authentication.

Input object (in JSON format), which includes the following fields:

• name(string): Name of the meeting.
• dateFrom(date and time): Date and time of the meeting's start.
• dateTo(date and time): Date and time of the meeting's end.
• objective(string): The goal or purpose of the meeting.
• teamId(number): Identifier of the team to which the meeting belongs.
• location(string): Location of the meeting.

• If dateFrom is filled in, this field is required.

• sectionId(number): Identifier of the section where the meeting should be placed.

Response

After successfully creating a meeting, the JSON response will contain confirmation of the meeting creation with the following information:

{

    "name": "testing meeting",

    "dateFrom": null,

    "dateTo": null,

    "location": null,

    "id": 1155147,

    "team": {

        "id": 1709278,

        "name": "new team testing"

    },

    "meetingType": null,

    "leader": {

        "id": 319974784,

        "fullName": "John Blue"

    },

    "recorder": {

        "id": 319454974,

        "fullName": "Jane Black"

    },

    "owner": {

        "id": 381976974,

        "fullName": "John Blue"

    },

    "tags": {},

    "state": "OPEN",

    "phase": null,

    "deleted": false,

    "section": null,

    "sectionId": null,

    "conferenceUrl": "DEFAULT_CONFERENCE_SERVICE",

    "sortOrder": 10080.0,

    "objective": null,

    "modificationState": "NO_MODIFICATION",

    "createdAt": "2023-09-18T09:24:38.301Z",

    "summary": null,

    "ownerInfo": null,

    "tenant": 20150012,

    "lastModified": "2023-09-18T09:24:38.301Z",

    "deletedAt": null

}

Description of attributes:

• name: String describing the name of the meeting.
• dateFrom: This field contains the start date and time of the meeting.
• dateTo: This field contains the end date and time of the meeting.
• location: This field contains the location of the meeting.
• id: This is a unique identifier of the meeting in the system.
• team: This field contains information about the team to which the meeting belongs.
• meetingType: This field contains the type of meeting.
• leader: This field contains information about the meeting leader. It includes the leader's identifier (id) and their full name (fullName).
• recorder: This field contains information about the meeting recorder. It includes the recorder's identifier (id) and their full name (fullName).
• owner: This field contains information about the meeting owner. It includes the owner's identifier (id) and their full name (fullName).
• tags: This field contains tags or labels assigned to the meeting.
• state: Defines the state of the meeting. The state can be "OPEN" or "CLOSED," depending on whether the meeting is active or closed.
• phase: This field contains the phase of the meeting if defined.
• deleted: This field indicates whether the meeting is marked as deleted (true) or not (false).
• section: This field contains information about the section to which the meeting is assigned.
• sectionId: This field contains the identifier of the section where the meeting should be placed.
• conferenceUrl: This field contains the URL address for the conference service.
• sortOrder: This number determines the order of the meeting in the list of meetings or hierarchical tree of meetings.
• objective: This field contains the objective or purpose of the meeting if defined.
• modificationState: This field indicates the modification state of the meeting.
• createdAt: This field contains the date and time of meeting creation.
• summary: This field contains the summary of the meeting.
• ownerInfo: This field contains information about the owner of the meeting.
• tenant: This field contains the identifier of the tenant or organization associated with the meeting.
• lastModified: This field contains the date and time of the last modification of the meeting.
• deletedAt: This field contains the date and time of meeting deletion if it's deleted.

‍