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 Batch Portal Operations API

Perform bulk operations on portal flag states

HubSpot Batch Portal 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 Batch Portal Operations. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, code examples, and 652 JSON Schemas.

This API exposes 2 operations across 2 paths, and defines 11 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.

2 operations 2 paths 11 schemas 2 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 Batch Portal Operations API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (OAuth2) using the authorizationCode flow, exposing 1 scope.

Paths & Operations 2

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

Batch Portal Operations 2

Perform bulk operations on portal flag states

POST
/feature-flags/v3/{appId}/flags/{flagName}/portals/batch/upsert
Hubspot Batch Create or Update Portal Flag States
batchUpsertPortalFlagStates 2 params body → 200207400401500
POST
/feature-flags/v3/{appId}/flags/{flagName}/portals/batch/delete
Hubspot Batch Delete Portal Flag States
batchDeletePortalFlagStates 2 params body → 200207400401500

Schemas 11

The contract defines 11 schemas that model the data the API accepts and returns. The most detailed are Error (7 properties), ErrorDetail (5 properties), BatchPortalFlagStateResponseWithErrors (5 properties), PortalFlagState (4 properties). Each schema is shown below with its type and property counts.

ErrorDetail
object
Detailed error information for specific validation failures
5 properties 1 required
FlagState
string
The state of a feature flag
BatchDeleteInput
object
Input payload for batch deleting portal flag states
1 property 1 required
BatchError
object
Represents an error that occurred for a specific item in a batch operation
4 properties 3 required
Error
object
Represents an error response from the API
7 properties 3 required
BatchPortalFlagStateResponseWithErrors
object
Response for batch operations that had some failures
5 properties 2 required
BatchPortalFlagStateResponse
object
Response for successful batch portal flag state operations
4 properties 2 required
PortalFlagState
object
Represents the flag state override for a specific portal (account)
4 properties 4 required
BatchPortalFlagStateInputItem
object
Individual item in a batch upsert request
2 properties 2 required
BatchDeleteInputItem
object
Individual item in a batch delete request
1 property 1 required
BatchPortalFlagStateInput
object
Input payload for batch creating or updating portal flag states
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

hubspot-batch-portal-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