Skip to main content
POST
Create a meeting

Authorizations

Authorization
string
header
required

OAuth 2.0 Bearer Token from Clerk authentication

Headers

Idempotency-Key
string

Unique key to ensure idempotent request handling. If a request with the same key was already processed, the original response will be returned.

Body

application/json
book_id
string
required

The book ID

Example:

"abc123xyz"

title
string
required

Meeting title

Example:

"Client Review"

start_time
string<date-time>
required

Meeting start time (ISO8601). Must be in the past.

Example:

"2024-01-15T10:00:00Z"

end_time
string<date-time>

Meeting end time (ISO8601)

Example:

"2024-01-15T11:00:00Z"

notepad
string

Meeting notes (markdown)

Example:

"## Agenda\\n\\n- Review portfolio"

household_ids
string[]

Array of household IDs to link to this meeting

Response

meeting created

id
string
required
title
string
required
book_id
string
required
households
object[]
required
has_transcript
boolean
required
has_recordings
boolean
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
start_time
string<date-time> | null
end_time
string<date-time> | null
duration_seconds
integer
meeting_source
enum<string> | null
Available options:
instant,
calendar_event,
imported,
logged
meeting_type
string
users
object[]
quick_summary
string | null
ai_summary
string | null
notepad
string | null
transcript
array | null
event_participants
array | null