ATattio
Meetings

Update a meeting (append linked records)

Changed on

Links records to a meeting. The records supplied are added to the meeting's existing linked records, and records which are already linked are ignored. Use the PUT endpoint to replace or remove linked records.

No other meeting fields can be updated. Attio automatically links the meeting participants' companies to the meeting; this behavior is asynchronous.

This endpoint is in beta. We will aim to avoid breaking changes, but small updates may be made as we roll out to more users.

Required scopes: meeting:read-write, record_permission:read.

Supported token levels: workspace, user.

patch/v2/meetings/{meeting_id}

Request

  • Base URL
    https://api.attio.com
  • URL
    https://api.attio.com/v2/meetings/{meeting_id}
  • Auth
    OAuth 2
    Authorization code: https://app.attio.com/authorize
    Token URL: https://app.attio.com/oauth/token scopes: meeting:read-write, record_permission:read

Path parameters

meeting_idstring uuid required

A UUID which identifies the meeting to update.

Example:cb59ab17-ad15-460c-a126-0715617c0853

Request body

Example request

{
  "data": {
    "linked_records": [
      {
        "object": "people",
        "record_id": "891dcbfc-9141-415d-9b2a-2238a6cc012d"
      }
    ]
  }
}

Response

Success

Example response

{
  "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.",
    "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",
        "email_address": "person@company.com",
        "name": "Simon Mitchell"
      }
    ],
    "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"
    }
  }
}

Changes