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

Klaviyo Custom Objects API

custom objects

Klaviyo Custom Objects API is one of 23 APIs that Klaviyo publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

Tagged areas include Custom Objects. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an AsyncAPI specification, an API reference, authentication docs, and rate-limit docs.

This API exposes 6 operations across 4 paths, and defines 17 schemas. It is described by OpenAPI 3.0.2, at version 2026-04-15.

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

6 operations 4 paths 17 schemas 1 DELETE2 GET3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.2
API Version
2026-04-15
Base URL
https://a.klaviyo.com
Authentication
API Key
License
Terms of Service
Resource Areas
1

Authentication & Security 1

Klaviyo Custom Objects API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (Klaviyo-API-Key). By default, every request must be authenticated.

  • Klaviyo-API-Key — Private key authentication for /api/ endpoints is performed by setting the Authorization header to Klaviyo-API-Key your-private-api-key For more information pl…

Paths & Operations 6

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

Custom Objects 6

custom objects

GET
/api/data-sources
Get Data Sources
get_data_sources 4 params → 2004XX5XX
POST
/api/data-sources
Create Data Source
create_data_source 1 param body → 2014XX5XX
GET
/api/data-sources/{id}
Get Data Source
get_data_source 3 params → 2004XX5XX
DELETE
/api/data-sources/{id}
Delete Data Source
delete_data_source 2 params → 2044XX5XX
POST
/api/data-source-record-bulk-create-jobs
Bulk Create Data Source Records
bulk_create_data_source_records 1 param body → 2044XX5XX
POST
/api/data-source-record-create-jobs
Create Data Source Record
create_data_source_record 1 param body → 2044XX5XX

Schemas 17

The contract defines 17 schemas that model the data the API accepts and returns. The most detailed are CollectionLinks (5 properties), DataSourceResponseObjectResource (4 properties), DataSourceRecordCreateJobCreateQueryResourceObject (3 properties), DataSourceRecordBulkCreateJobCreateQueryResourceObject (3 properties). Each schema is shown below with its type and property counts.

DataSourceRecordCreateJobCreateQuery
object
1 property 1 required
DataSourceRecordBulkCreateJobCreateQueryResourceObject
object
3 properties 2 required
DataSourceRecordBulkCreateJobCreateQuery
object
1 property 1 required
GetDataSourceResponseCollection
object
2 properties 1 required
DataSourceCreateQuery
object
1 property 1 required
DataSourceRecordCreateJobEnum
string
DataSourceRecordCreateJobCreateQueryResourceObject
object
3 properties 2 required
DataSourceEnum
string
DataSourceResponseObjectResource
object
4 properties 4 required
DataSourceCreateQueryResourceObject
object
2 properties 2 required
DataSourceRecordBulkCreateJobEnum
string
DataSourceRecordEnum
string
PostDataSourceResponse
object
2 properties 1 required
DataSourceRecordResourceObject
object
2 properties 2 required
GetDataSourceResponse
object
2 properties 1 required
ObjectLinks
object
1 property 1 required
CollectionLinks
object
5 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

klaviyo-custom-objects-api-openapi.yml Raw ↑

Other APIs Klaviyo publishes across the network.

Klaviyo Accounts API
Klaviyo Campaigns API
Klaviyo Catalogs API
Klaviyo Client API
Klaviyo Conversations API
Klaviyo Coupons API
Klaviyo Data Privacy API
Klaviyo Events API
Klaviyo Flows API
Klaviyo Forms API
Klaviyo Images API
Klaviyo Lists API