Sign in

v19

latestOpenAPI 3.1.1raw.githubusercontent.com2026-08-017489931.2 KB

Create a meeting

Creates a new meeting record. This endpoint only supports creation of meetings in the past. The $title, $startDate, and $endDate fields are required. Only the $transcript relationship is writable on create; all other meeting relationships are system-managed. The $account and $opportunity relationships are read-only and are derived from the meeting's $contact attendees and the accounts/opportunities those contacts belong to. The response is privacy-aware and includes a read-only accessLevel. See <u>Uploading meeting transcripts</u> for the full file upload and transcript attachment flow.

Supports idempotency via the Idempotency-Key header.

Required scope: meetings:create

Rate limit category: Write

post/v1/meetings

Headers

Lightfield-Version'2026-03-01' required

Required API version header. Requests may error without it.

Request body

autoCreateRecordsboolean

When true, the initial post-create meeting sync may auto-create account and contact records for external attendees.

Response

OK

idstring required

Unique identifier for the entity.

createdAtstring required

ISO 8601 timestamp of when the entity was created.

updatedAtstring nullable required

ISO 8601 timestamp of when the entity was last updated, or null.

httpLinkstring nullable required

URL to view the entity in the Lightfield web app, or null.

externalIdstring nullable

External identifier for the entity, or null if unset.

fieldsobject required

Map of field names to their typed values. System fields are prefixed with $ (e.g. $name, $email); custom attributes use their bare slug.

relationshipsobject required

Map of relationship names to their associated entities. System relationships are prefixed with $ (e.g. $owner, $contact).

objectType'meeting' required

Always meeting.

accessLevel'FULL' | 'METADATA' required

The caller's resolved access level for this meeting.