HubSpot Appointments

Name: Appointments API
Brand: Appointments
Availability: InStock

✓ Official Vendor SpecCRMContact Managementoauth2, apiKey11 EndpointsREST

Install Jentic One Beta

Connect the Appointments to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Appointments, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Appointments API.

Create individual or batched appointment records with custom properties

Update appointments by internal ID or unique property values

Archive appointments individually or in batches

Search appointments using HubSpot's CRM search filters and sorts

GET STARTED

Start building with Appointments API

Explore with Jentic

View OpenAPI Document

For Agents

Create, read, update, and search HubSpot CRM appointment objects, including batch and upsert operations. Useful for agents synchronising appointments between HubSpot and another scheduling system.

Use for: Create a new HubSpot appointment record for a sales meeting, List all upcoming appointment objects in HubSpot, Update an appointment's status or scheduled time, Search for appointments scheduled with a specific contact

Not supported: Does not send calendar invites, manage availability, or render booking pages — use for HubSpot CRM appointment object operations only.

Use Cases

Patterns agents use Appointments API for, with concrete tasks.

★ Calendar Sync into HubSpot

Import a stream of new and updated appointments from an external scheduling tool into HubSpot CRM. The Appointments API exposes batch upsert keyed on a unique property, so the agent can re-run the sync idempotently without creating duplicate records.

POST /crm/v3/objects/{objectType}/batch/upsert with objectType=appointments and a list of appointment payloads keyed by an external ID property.

Pipeline Reporting on Meetings

Query appointment records associated with a sales pipeline to compute meeting volume, no-show rates, or rep coverage. Search supports filters and sorts so the agent can pull only the appointments matching the report's criteria, paginated.

POST /crm/v3/objects/{objectType}/search with objectType=appointments and a filter on hs_appointment_start within the reporting window.

Cancellation and Rescheduling Workflow

When a customer cancels via an external portal, archive the matching HubSpot appointment and create a replacement record for the rescheduled time. The API supports both archive and create as single calls or as part of a batch, suitable for high-volume scheduling integrations.

DELETE /crm/v3/objects/{objectType}/{objectId} for the cancelled appointment, then POST /crm/v3/objects/{objectType} to create the rescheduled record.

Agent-Driven Appointment Operations

Wire HubSpot appointment management into an AI scheduling assistant via Jentic. The agent searches by intent for the right operation, loads the input schema, and executes — no HubSpot client code required, and credentials stay in the Jentic vault.

Use Jentic search 'create a HubSpot appointment record', load the POST /crm/v3/objects/{objectType} schema with objectType=appointments, and execute with the appointment payload.

Key Endpoints

11 endpoints — the hubspot appointments api exposes the appointment object inside hubspot crm as a generic object resource.

METHOD

PATH

DESCRIPTION

GET

/crm/v3/objects/{objectType}

List appointment objects

POST

/crm/v3/objects/{objectType}

Create an appointment

GET

/crm/v3/objects/{objectType}/{objectId}

Read an appointment by ID

PATCH

/crm/v3/objects/{objectType}/{objectId}

Update an appointment

DELETE

/crm/v3/objects/{objectType}/{objectId}

Archive an appointment

POST

/crm/v3/objects/{objectType}/batch/upsert

Upsert a batch of appointments

POST

/crm/v3/objects/{objectType}/search

Search appointments

GET

/crm/v3/objects/{objectType}

List appointment objects

POST

/crm/v3/objects/{objectType}

Create an appointment

GET

/crm/v3/objects/{objectType}/{objectId}

Read an appointment by ID

PATCH

/crm/v3/objects/{objectType}/{objectId}

Update an appointment

DELETE

/crm/v3/objects/{objectType}/{objectId}

Archive an appointment

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

HubSpot OAuth and private app tokens for the Appointments API are stored encrypted in the Jentic vault. The agent receives a scoped execution token; the raw HubSpot credential never enters its prompt context.

Intent-based discovery

Agents search Jentic with intents like 'create a HubSpot appointment' or 'search HubSpot appointments' and Jentic returns the matching CRM object operation with its input schema, ready to call.

Time to first call

Direct integration including OAuth, custom property handling, and batch logic typically takes 1-2 days. Through Jentic: under 30 minutes.

FAQs

Specific to using Appointments API through Jentic.

What authentication does the HubSpot Appointments API use?

OAuth 2.0 authorization code flow or a private app token in either the `private-app` or `private-app-legacy` header. Through Jentic, the credential lives encrypted in the vault and the agent only ever sees a scoped execution token.

Can I upsert appointments to avoid duplicate records?

Yes. POST /crm/v3/objects/{objectType}/batch/upsert with objectType=appointments accepts a unique property key — HubSpot creates new records or updates existing ones based on that key, which is the right pattern for idempotent calendar syncs.

What are the rate limits for the Appointments API?

Standard HubSpot CRM API limits apply — 100 requests per 10 seconds per OAuth app, with daily caps on most paid tiers. Use batch read, batch upsert, and batch update endpoints to stay well within limits during bulk syncs.

How do I search HubSpot appointments by date through Jentic?

Search Jentic for `search HubSpot appointments`, load the POST /crm/v3/objects/{objectType}/search schema with objectType=appointments, and execute with a filter on the appointment start date property. Install with `pip install jentic` and authenticate using `JENTIC_AGENT_API_KEY`.

Does this API expose default appointment properties?

Yes. As with other HubSpot CRM objects, the appointment endpoints return a property map per record. You can also pass an explicit `properties` query parameter on read calls to control which properties HubSpot returns.

HubSpot Appointments

Connect the Appointments to your agent

Capabilities

Start building with Appointments API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs