Batch

Read a batch of meetings by internal ID, or unique property values

Changed on Oct 30, 2026

Retrieve records by record ID or include the idProperty parameter to retrieve records by a custom unique value property.

post/crm/objects/2026-09/meetings/batch/read

Request

Base URL
https://api.hubapi.com
Auth
- OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.tickets.write
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.tickets.read
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.deals.read
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.services.read
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.subscriptions.read
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.tickets.sensitive.read
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.orders.read
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.listings.write
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.custom.read
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.companies.write
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.custom.sensitive.write.v2
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.tasks.read
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.custom.highly_sensitive.write.v2
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.companies.read
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.appointments.sensitive.read.v2
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.contacts.highly_sensitive.read.v2
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.forecasts.read
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.tickets.highly_sensitive.read
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.companies.sensitive.read.v2
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.tickets.sensitive.write
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopesmedia_bridge.read
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.deals.highly_sensitive.read.v2
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.contacts.highly_sensitive.write.v2
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.contracts.read
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.companies.highly_sensitive.read.v2
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.commercepayments.write
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.invoices.write
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.contacts.sensitive.write.v2
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.calls.read
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.users.write
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.custom.sensitive.read.v2
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.meetings.read
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.users.read
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.orders.write
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.partner-services.read
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.partner-services.write
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.appointments.write
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.projects.highly_sensitive.write
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.carts.write
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.tickets.highly_sensitive.write
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.tasks.write
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.commercepayments.read
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopesrevenue.contracts.read
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.feedback_submissions.read
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.products.write
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.services.write
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.emails.write
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.subscriptions.write
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.deals.sensitive.write.v2
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.contacts.read
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.appointments.sensitive.write.v2
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescpq.price_books.read
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.meetings.write
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.invoices.read
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.projects.highly_sensitive.read
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.custom.write
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.notes.write
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopestickets.sensitive.v2
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.deals.write
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopese-commerce
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.appointments.read
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.companies.sensitive.write.v2
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.projects.read
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.companies.highly_sensitive.write.v2
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.custom.highly_sensitive.read.v2
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.deals.highly_sensitive.write.v2
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.calls.write
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.goals.write
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.line_items.write
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.projects.sensitive.read
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.contacts.write
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.goals.read
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.line_items.read
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.partner-clients.write
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.projects.write
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.deals.sensitive.read.v2
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.projects.sensitive.write
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.quotes.write
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopestickets.highly_sensitive.v2
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.leads.read
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.leads.write
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.carts.read
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.emails.read
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.courses.write
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.quotes.read
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.partner-clients.read
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.courses.read
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.notes.read
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.listings.read
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.contacts.sensitive.read.v2
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopescrm.objects.products.read
- or OAuth 2
  Authorization codehttps://app.hubspot.com/oauth/authorize
  Token URLhttps://api.hubapi.com/oauth/v1/token
  Scopesoauth
TypeScript
https://skmtc.dev/hubspot/apis/crm-meetings/docs/crm/objects/2026-09/meetings/batch/read/post.ts
A function with typed inputs. Its response is checked against the schema.

Query parameters

archivedboolean

Whether to return only results that have been archived.

Request body

idPropertystring

When using a custom unique value property to retrieve records, the name of the property. Do not include this parameter if retrieving by record ID.

propertiesstring[] required

An array of strings representing the properties to be returned for each object. If a specified property is not present on an object, it will be ignored.

propertiesWithHistorystring[] required

An array of strings indicating the properties to be returned along with their history of previous values. Specifying properties here will reduce the maximum number of objects that can be read in a single request.

Example request

{
  "inputs": [
    {
      "id": "430001"
    }
  ]
}

Response

successful operation

completedAtstring date-time required

The date and time when the batch operation was completed, in ISO 8601 format.

linksobject

A map of link names to associated URIs for additional information related to the batch operation.

requestedAtstring date-time

The date and time when the batch operation was requested, in ISO 8601 format.

startedAtstring date-time required

The date and time when the batch operation started, in ISO 8601 format.

status'CANCELED' | 'COMPLETE' | 'PENDING' | 'PROCESSING' required

The current status of the batch operation. Valid values include 'PENDING', 'PROCESSING', 'CANCELED', and 'COMPLETE'.

Changes

Oct 30, 20262026-09b28e3ceafbcb Revision changes
- info
  the security scope crm.objects.tickets.write was added to the endpoint's security scheme oauth2
- info
  the security scope crm.objects.products.read was removed from the endpoint's security scheme oauth2
Oct 30, 20262026-09dbf926197cc1 Revision changes
- info
  the security scope crm.objects.deals.read was added to the endpoint's security scheme oauth2
- info
  the security scope crm.objects.products.read was removed from the endpoint's security scheme oauth2

Operation history (10 revisions)