Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

HubSpot Basic Operations API

Create, read, update, and delete individual call records

HubSpot Basic Operations API is one of 93 APIs that HubSpot publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 652 JSON Schema definitions.

Tagged areas include Basic Operations. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, code examples, and 652 JSON Schemas.

This API exposes 10 operations across 4 paths, and defines 18 schemas. It is described by OpenAPI 3.1.0, at version 3.0.0.

Requests are made against a single base URL, https://api.hubapi.com.

10 operations 4 paths 18 schemas 2 DELETE4 GET2 PATCH2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
3.0.0
Base URL
https://api.example.com
Authentication
OAuth 2.0
License
Resource Areas
1

Authentication & Security 1

HubSpot Basic Operations API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (OAuth2) using the authorizationCode flow, exposing 1 scope.

Paths & Operations 10

Across 4 paths, the API surfaces 10 operations — 2 DELETE, 4 GET, 2 PATCH, 2 POST. Each is listed below with its method, path, parameters, and response codes.

Basic Operations 10

Create, read, update, and delete individual call records

GET
/crm/v3/objects/calls
Hubspot List All Calls
listCalls 6 params → 200default
POST
/crm/v3/objects/calls
Hubspot Create a Call
createCall body → 201default
GET
/crm/v3/objects/calls/{callId}
Hubspot Get a Call by Id
getCallById 5 params → 200default
PATCH
/crm/v3/objects/calls/{callId}
Hubspot Update a Call
updateCall 1 param body → 200default
DELETE
/crm/v3/objects/calls/{callId}
Hubspot Archive a Call
archiveCall 1 param → 204default
GET
/crm/v3/objects/notes
Hubspot List All Notes
listNotes 6 params → 200default
POST
/crm/v3/objects/notes
Hubspot Create a Note
createNote body → 201default
GET
/crm/v3/objects/notes/{noteId}
Hubspot Get a Note by Id
getNoteById 5 params → 200default
PATCH
/crm/v3/objects/notes/{noteId}
Hubspot Update a Note
updateNote 1 param body → 200default
DELETE
/crm/v3/objects/notes/{noteId}
Hubspot Archive a Note
archiveNote 1 param → 204default

Schemas 18

The contract defines 18 schemas that model the data the API accepts and returns. The most detailed are Error (7 properties), Note (7 properties), Call (7 properties), PropertyHistory (6 properties). Each schema is shown below with its type and property counts.

PropertyHistory
object
Historical value of a property
6 properties
CallCollectionResponse
object
A paginated collection of calls
2 properties 1 required
AssociationInput_2
object
Association to create with another object
2 properties 2 required
AssociationType_2
object
Type of association
2 properties 2 required
ErrorDetail
object
Detailed error information
5 properties 1 required
CallUpdateRequest
object
Request body for updating a call
1 property 1 required
Note
object
Represents a note engagement in the CRM
7 properties 5 required
Paging
object
Pagination information
1 property
AssociationInput
object
Association to create with another object
2 properties 2 required
NoteCollectionResponse
object
A paginated collection of notes
2 properties 1 required
NoteCreateRequest
object
Request body for creating a note
2 properties 1 required
CallCreateRequest
object
Request body for creating a call
2 properties 1 required
NextPage
object
Information about the next page
2 properties 1 required
Error
object
Error response
7 properties 3 required
NoteUpdateRequest
object
Request body for updating a note
1 property 1 required
Call
object
Represents a call engagement in the CRM
7 properties 5 required
AssociationType
object
Type of association
2 properties 2 required
PropertyHistory_2
object
Historical value of a property
6 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

hubspot-basic-operations-api-openapi.yml Raw ↑

Other APIs HubSpot publishes across the network.

HubSpot Posts API
HubSpot URL Redirects API
HubSpot Pipelines API
HubSpot Products API
HubSpot Line Items API
HubSpot Quotes API
HubSpot CRM Properties API
HubSpot Owners API
HubSpot CRM Imports API
HubSpot Custom Objects API
HubSpot Marketing Events API
HubSpot Forms API