Get a meeting

curl --request GET \
  --url https://api.attio.com/v2/meetings/{meeting_id} \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "id": {
      "workspace_id": "14beef7a-99f7-4534-a87e-70b564330a4c",
      "meeting_id": "cb59ab17-ad15-460c-a126-0715617c0853"
    },
    "title": "Onboarding Session",
    "description": "Getting you up to speed with the platform and answering any questions you have.",
    "is_all_day": false,
    "start": {
      "datetime": "2027-11-27T14:00:00.000-04:00",
      "timezone": "America/New_York"
    },
    "end": {
      "datetime": "2027-11-27T15:00:00.000-04:00",
      "timezone": "America/New_York"
    },
    "participants": [
      {
        "status": "accepted",
        "is_organizer": false,
        "email_address": "[email protected]"
      }
    ],
    "linked_records": [
      {
        "object_slug": "people",
        "object_id": "891dcbfc-9141-415d-9b2a-2238a6cc012d",
        "record_id": "891dcbfc-9141-415d-9b2a-2238a6cc012d"
      }
    ],
    "created_at": "2023-01-01T15:00:00.000000000Z",
    "created_by_actor": {
      "type": "workspace-member",
      "id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
    }
  }
}

GET

meetings

{meeting_id}

Get a meeting

curl --request GET \
  --url https://api.attio.com/v2/meetings/{meeting_id} \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "id": {
      "workspace_id": "14beef7a-99f7-4534-a87e-70b564330a4c",
      "meeting_id": "cb59ab17-ad15-460c-a126-0715617c0853"
    },
    "title": "Onboarding Session",
    "description": "Getting you up to speed with the platform and answering any questions you have.",
    "is_all_day": false,
    "start": {
      "datetime": "2027-11-27T14:00:00.000-04:00",
      "timezone": "America/New_York"
    },
    "end": {
      "datetime": "2027-11-27T15:00:00.000-04:00",
      "timezone": "America/New_York"
    },
    "participants": [
      {
        "status": "accepted",
        "is_organizer": false,
        "email_address": "[email protected]"
      }
    ],
    "linked_records": [
      {
        "object_slug": "people",
        "object_id": "891dcbfc-9141-415d-9b2a-2238a6cc012d",
        "record_id": "891dcbfc-9141-415d-9b2a-2238a6cc012d"
      }
    ],
    "created_at": "2023-01-01T15:00:00.000000000Z",
    "created_by_actor": {
      "type": "workspace-member",
      "id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
    }
  }
}

Authorizations

Authorization

string

header

required

This API uses OAuth 2.0 with the authorization code grant flow.

Path Parameters

meeting_id

string<uuid>

required

A UUID which identifies the meeting.

Example:

"cb59ab17-ad15-460c-a126-0715617c0853"

Response

Success

data

object

required

Show child attributes

data.id

object

required

Show child attributes

data.id.workspace_id

string<uuid>

required

The ID of the workspace the meeting belongs to.

Example:

"14beef7a-99f7-4534-a87e-70b564330a4c"

data.id.meeting_id

string<uuid>

required

The ID of the Attio meeting.

Example:

"cb59ab17-ad15-460c-a126-0715617c0853"

data.title

string

required

The title of the meeting.

Example:

"Onboarding Session"

data.description

string

required

The description of the meeting.

Example:

"Getting you up to speed with the platform and answering any questions you have."

data.is_all_day

boolean

required

Whether or not the meeting is an all day event. All day events may span multiple days.

Example:

false

data.start

object

required

Option 1
Option 2

Show child attributes

data.start.datetime

string

required

If a non-all day event, a datetime representing when the meeting starts. Datetimes are formatted as UTC if no timezone is available. If a timezone is available, the datetime will offset using the specified timezone.

Example:

"2027-11-27T14:00:00.000-04:00"

data.start.timezone

string | null

required

The IANA timezone in which the meeting starts, if available.

Example:

"America/New_York"

data.end

object

required

Option 1
Option 2

Show child attributes

data.end.datetime

string

required

A datetime representing when the meeting ends. All day meetings will return a date whereas non-all day meetings will return a datetime. Datetimes do not include timezone information; please refer to timezone for timezone information. Following iCalendar RFC 5545, the end_at property is exclusive, meaning that the meeting ends before the specified time, not at it. For example, a one day meeting on June 3rd would have an end_at of June 4th, not June 3rd; a one hour meeting starting at 14:00 would have an end_at of 15:00, not 14:00.

Example:

"2027-11-27T15:00:00.000-04:00"

data.end.timezone

string | null

required

The IANA timezone in which the meeting ends, if available.

Example:

"America/New_York"

data.participants

object[]

required

Show child attributes

data.participants.status

enum<string>

required

The status of the individual meeting participant.

Available options:

accepted,

tentative,

declined,

pending

Example:

"accepted"

data.participants.is_organizer

boolean

required

Whether or not the participant is the organizer of the meeting.

Example:

false

data.participants.email_address

string | null

required

The normalized email address of the meeting participant.

Example:

"[email protected]"

data.linked_records

object[]

required

A list of records that are linked to the meeting. Participants with matching person records are automatically linked to the meeting but other records may also be linked explicitly.

Show child attributes

data.linked_records.object_slug

string

required

The slug of the object the meeting linked record belongs to.

Example:

"people"

data.linked_records.object_id

string<uuid>

required

The ID of the object the meeting linked record belongs to.

Example:

"891dcbfc-9141-415d-9b2a-2238a6cc012d"

data.linked_records.record_id

string<uuid>

required

The ID of the meeting linked record.

Example:

"891dcbfc-9141-415d-9b2a-2238a6cc012d"

data.created_at

string

required

Timestamp representing when the meeting was created.

Example:

"2023-01-01T15:00:00.000000000Z"

data.created_by_actor

object

required

The actor that created this meeting.

Show child attributes

data.created_by_actor.id

string | null

An ID to identify the actor.

data.created_by_actor.type

enum<string> | null

The type of actor. Read more information on actor types here.

Available options:

api-token,

workspace-member,

system,

app

Example:

{
  "type": "workspace-member",
  "id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
}

List meetings List call recordings

⌘I

Introduction

Guides

Tutorials

Endpoint reference

Webhook reference

Get a meeting

Authorizations

Path Parameters

Response