Guide: Create & Update a Meeting

How to create a new meeting and update its details via the API.

Prerequisites

A valid API token
A board ID with write access (requires collaborator role or higher)

Create a Meeting

Send a POST request with at least a title. All other fields are optional.

curl -s -X POST "https://app.imboard.ai/api/v1/boards/BOARD_ID/meetings" \
  -H "Authorization: Bearer imb_pat_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Q1 Board Review",
    "locationType": "virtual",
    "virtualMeetingUrl": "https://zoom.us/j/123456789",
    "startTime": "2026-04-15T10:00:00Z",
    "endTime": "2026-04-15T12:00:00Z"
  }' | jq

Available Fields

Field	Type	Required	Description
`title`	string	Yes	Meeting title (max 200 characters)
`status`	string	No	Lifecycle status: `draft`, `scheduled`, `in_progress`, `completed`
`locationType`	string \| null	No	`virtual`, `in_person`, or `hybrid`
`location`	string \| null	No	Physical location (max 255 characters)
`virtualMeetingUrl`	string \| null	No	Virtual meeting URL (max 255 characters)
`startTime`	string \| null	No	ISO-8601 start time
`endTime`	string \| null	No	ISO-8601 end time (must be after `startTime` if both provided)

Update a Meeting

Send a PATCH request with only the fields you want to change. At least one field is required.

curl -s -X PATCH "https://app.imboard.ai/api/v1/boards/BOARD_ID/meetings/MEETING_ID" \
  -H "Authorization: Bearer imb_pat_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Q1 Board Review (Updated)",
    "status": "scheduled"
  }' | jq

Guide: Create & Update a Meeting

Prerequisites

Create a Meeting

Available Fields

Update a Meeting

See Also

On this page