Skip to main content
POST
/
v1
/
meetings
Create a meeting
curl --request POST \
  --url https://api.slant.app/v1/meetings \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "book_id": "abc123xyz",
  "title": "Client Review",
  "start_time": "2024-01-15T10:00:00Z",
  "end_time": "2024-01-15T11:00:00Z",
  "notepad": "## Agenda\\n\\n- Review portfolio",
  "household_ids": [
    "<string>"
  ]
}
'
{
  "id": "<string>",
  "title": "<string>",
  "book_id": "<string>",
  "households": [
    {
      "id": "<string>",
      "name": "<string>"
    }
  ],
  "has_transcript": true,
  "has_recordings": true,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "start_time": "2023-11-07T05:31:56Z",
  "end_time": "2023-11-07T05:31:56Z",
  "duration_seconds": 123,
  "meeting_link": "<string>",
  "meeting_source": "instant",
  "meeting_type": "other",
  "quick_summary": "<string>",
  "ai_summary": "<string>",
  "notepad": "<string>",
  "transcript": "<array>",
  "event_participants": "<array>"
}

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_link
string | null
​
meeting_source
enum<string> | null
Available options:
instant,
calendar_event,
imported,
logged
​
meeting_type
enum<string>
Available options:
other,
client_review,
prospect,
client_check_in,
internal,
coi
​
quick_summary
string | null
​
ai_summary
string | null
​
notepad
string | null
​
transcript
array | null
​
event_participants
array | null