How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Klaviyo Segments 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 Segments. 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 11 operations across 8 paths, and defines 158 schemas. It is described by OpenAPI 3.2.0, at version 2026-04-15.

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

11 operations 8 paths 158 schemas 1 DELETE8 GET1 PATCH1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
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 Segments 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 11

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

Segments 11

segments

GET
/api/segments
Get Segments
get_segments 9 params → 2004XX5XX
POST
/api/segments
Create Segment
create_segment 1 param body → 2014XX5XX
GET
/api/segments/{id}
Get Segment
get_segment 7 params → 2004XX5XX
PATCH
/api/segments/{id}
Update Segment
update_segment 2 params body → 2004XX5XX
DELETE
/api/segments/{id}
Delete Segment
delete_segment 2 params → 2044XX5XX
GET
/api/segments/{id}/tags
Get Tags for Segment
get_tags_for_segment 3 params → 2004XX5XX
GET
/api/segments/{id}/relationships/tags
Get Tag IDs for Segment
get_tag_ids_for_segment 2 params → 2004XX5XX
GET
/api/segments/{id}/profiles
Get Profiles for Segment
get_profiles_for_segment 8 params → 2004XX5XX
GET
/api/segments/{id}/relationships/profiles
Get Profile IDs for Segment
get_profile_ids_for_segment 6 params → 2004XX5XX
GET
/api/segments/{id}/flow-triggers
Get Flows Triggered by Segment
get_flows_triggered_by_segment 3 params → 2004XX5XX
GET
/api/segments/{id}/relationships/flow-triggers
Get IDs for Flows Triggered by Segment
get_ids_for_flows_triggered_by_segment 2 params → 2004XX5XX

Schemas 158

The contract defines 158 schemas that model the data the API accepts and returns. The most detailed are ProfileLocation (10 properties), EmailMarketing (10 properties), PredictiveAnalytics (10 properties), WhatsappMarketingChannel (8 properties). Each schema is shown below with its type and property counts.

SegmentEnum
string
RecordedDateFilter
object
2 properties 2 required
ConstantContactIntegrationFilter
object
3 properties 3 required
PreferencePageFilter
object
3 properties 2 required
NoSMSMarketingUnsubscribed
object
2 properties 1 required
FlowEnum
string
ProfilePredictiveAnalyticsChannelAffinityRankCondition
object
5 properties 5 required
ProfileNoGroupMembershipCondition
object
3 properties 3 required
SftpMethodFilter
object
2 properties 2 required
FormSubscribeFilter
object
3 properties 2 required
CheckoutMethodFilter
object
2 properties 2 required
StringPhoneOperatorStringArrayFilter
object
3 properties 3 required
ListEnum
string
EffectiveDateFilter
object
2 properties 2 required
ManualImportMethodFilter
object
2 properties 2 required
HasEmailMarketingConsent
object
3 properties 3 required
ProfilePredictiveAnalyticsStringFilter
object
3 properties 3 required
GetSegmentProfilesRelationshipsResponseCollection
object
2 properties 1 required
ProfileModificationMethodFilter
object
2 properties 2 required
MessageBlockedMethodFilter
object
2 properties 2 required
CollectionLinks
object
5 properties 1 required
WhatsappChannel
object
3 properties
EmailMarketingListSuppression
object
3 properties 3 required
Subscriptions
object
4 properties
HasPushMarketingConsent
object
3 properties 3 required
ManualSuppressionDateFilter
object
2 properties 2 required
SubscribedSMSIsRcsCapableFilter
object
2 properties 2 required
TagGroupEnum
string
CarrierDeactivationMethodFilter
object
2 properties 2 required
ProvidedNoAgeMethodFilter
object
2 properties 2 required
ProvidedLandlineMethodFilter
object
2 properties 2 required
InvalidEmailDateFilter
object
2 properties 2 required
ProfilePredictiveAnalyticsChannelAffinityPriorityFilter
object
3 properties 3 required
SegmentDefinition
object
1 property 1 required
PatchSegmentPartialUpdateResponse
object
2 properties 1 required
ConstantContactIntegrationMethodFilter
object
3 properties 3 required
DataWarehouseImportMethodFilter
object
2 properties 2 required
NoSMSMarketing
object
1 property 1 required
APIMethodFilter
object
3 properties 2 required
FailedAgeGateMethodFilter
object
2 properties 2 required
GetSegmentListResponseCollectionCompoundDocument
object
3 properties 1 required
SegmentsProfileMetricFunnelCondition
object
4 properties 3 required
ManualImportManualMethodFilter
object
3 properties 2 required
ObjectLinks
object
1 property 1 required
ImplicitlyOrExplicitlyUnreachable
object
1 property 1 required
NoSMSMarketingConsent
object
3 properties 3 required
SegmentPartialUpdateQuery
object
1 property 1 required
PostSegmentCreateResponse
object
2 properties 1 required
ListLengthFilter
object
3 properties 3 required
StringArrayOperatorStringArrayFilter
object
3 properties 3 required
ProfilePredictiveAnalyticsStringCondition
object
3 properties 3 required
OneClickUnsubscribeMethodFilter
object
2 properties 2 required
HasEmailMarketingNeverSubscribed
object
2 properties 1 required
NoSMSMarketingNeverSubscribed
object
1 property 1 required
CampaignEnum
string
InboundMessageMethodFilter
object
2 properties 2 required
CustomSourceFilter
object
2 properties 2 required
ProfileMetricPropertyFilter
object
2 properties 1 required
ProfilePredictiveAnalyticsDateCondition
object
3 properties 3 required
NoEmailMarketingNeverSubscribed
object
2 properties 2 required
MethodFilter
object
2 properties 2 required
NumericOperatorNumericFilter
object
3 properties 3 required
ProfileRegionCondition
object
3 properties 3 required
NoPushMarketing
object
1 property 1 required
ProfilePredictiveAnalyticsNumericCondition
object
3 properties 3 required
HasSMSMarketingSubscribed
object
2 properties 1 required
IntegerFilter
object
3 properties 3 required
ProfileHasCustomObjectCondition
object
5 properties 5 required
ProfileEnum
string
EmailMarketing
object
10 properties 2 required
ExistenceOperatorExistenceFilter
object
2 properties 2 required
ExplicitlyReachable
object
2 properties 2 required
SMSChannel
object
2 properties
SegmentCreateQueryResourceObject
object
2 properties 2 required
IsSetExistenceFilter
object
2 properties 2 required
ProfilePropertyCondition
object
3 properties 3 required
NoEmailMarketingConsent
object
3 properties 3 required
ProfileHasGroupMembershipCondition
object
4 properties 3 required
SegmentListResponseObjectResource
object
5 properties 4 required
GreaterThanPositiveNumericFilter
object
3 properties 3 required
InStringArrayFilter
object
3 properties 3 required
DoubleOptinFilter
object
2 properties 2 required
WhatsappMarketingChannel
object
8 properties 3 required
LessThanPositiveNumericFilter
object
3 properties 3 required
ManualRemoveMethodFilter
object
2 properties 2 required
NoEmailMarketing
object
2 properties 1 required
ListSetFilter
object
3 properties 3 required
StatusDateFilter
object
2 properties 2 required
GetFlowResponseCollection
object
2 properties 1 required
BackInStockMethodFilter
object
2 properties 2 required
WhatsappConversationalChannel
object
8 properties 3 required
RelationshipLinks
object
2 properties 2 required
BounceDateFilter
object
2 properties 2 required
SegmentMemberResponseObjectResource
object
5 properties 3 required
SegmentPartialUpdateQueryResourceObject
object
3 properties 3 required
FlowActionEnum
string
WhatsappTransactionalChannel
object
8 properties 3 required
ListContainsOperatorListContainsFilter
object
3 properties 3 required
SegmentsProfileMetricCondition
object
6 properties 5 required
NumericRangeFilter
object
4 properties 4 required
ExplicitlyUnreachable
object
2 properties 2 required
ProfilePredictiveAnalyticsChannelAffinityPriorityCondition
object
5 properties 5 required
ImplicitlyOrExplicitlyReachable
object
1 property 1 required
RelativeDateRangeFilter
object
5 properties 5 required
EqualsStringFilter
object
3 properties 3 required
NoEmailMarketingUnsubscribed
object
2 properties 1 required
ShopifyIntegrationMethodFilter
object
3 properties 3 required
StaticDateRangeFilter
object
4 properties 4 required
RelativeAnniversaryDateFilter
object
4 properties 4 required
HasPushMarketing
object
2 properties 1 required
EmailMarketingSuppression
object
2 properties 2 required
GetSegmentMemberResponseCollection
object
2 properties 1 required
NoEmailMarketingSubscribed
object
2 properties 2 required
NoPushMarketingConsent
object
3 properties 3 required
AnniversaryDateFilter
object
2 properties 2 required
CalendarDateFilter
object
3 properties 3 required
TagResponseObjectResource
object
5 properties 4 required
ProfilePostalCodeDistanceCondition
object
5 properties 5 required
ConditionGroup
object
1 property 1 required
SegmentCreateQuery
object
1 property 1 required
SMSMarketing
object
6 properties 2 required
SMSTransactional
object
6 properties 2 required
StaticDateFilter
object
3 properties 3 required
SegmentRetrieveResponseObjectResource
object
5 properties 4 required
SpamComplaintMethodFilter
object
2 properties 2 required
HasEmailMarketingSubscribed
object
2 properties 1 required
ShopifyIntegrationFilter
object
3 properties 3 required
GetSegmentRetrieveResponseCompoundDocument
object
3 properties 1 required
PreferencePageMethodFilter
object
2 properties 2 required
ProfileLocation
object
10 properties
ImplicitlyUnreachable
object
1 property 1 required
ProfileHasCustomObjectFilter
object
2 properties 2 required
FlowResponseObjectResource
object
5 properties 4 required
BulkRemoveMethodFilter
object
2 properties 2 required
PushMarketing
object
3 properties 2 required
EmailChannel
object
1 property
MailboxProviderMethodFilter
object
2 properties 2 required
AlltimeDateFilter
object
2 properties 2 required
TagEnum
string
HasEmailMarketing
object
2 properties 1 required
PushTokenEnum
string
ListSubstringFilter
object
3 properties 3 required
RelativeDateOperatorBaseRelativeDateFilter
object
4 properties 4 required
BooleanFilter
object
3 properties 3 required
FormMethodFilter
object
3 properties 2 required
ProfilePermissionsCondition
object
3 properties 3 required
HasSMSMarketingConsent
object
3 properties 3 required
GetSegmentFlowTriggersRelationshipsResponseCollection
object
2 properties 1 required
StringOperatorStringFilter
object
3 properties 3 required
ProfileMetricFunnelSteps
object
3 properties 2 required
ProfileMarketingConsentCondition
object
2 properties 2 required
GetSegmentTagsRelationshipsResponseCollection
object
2 properties 1 required
GetTagResponseCollection
object
2 properties 1 required
PushChannel
object
1 property
PredictiveAnalytics
object
10 properties
ImplicitlyReachable
object
1 property 1 required
ManualAddManualMethodFilter
object
3 properties 2 required
ProfilePredictiveAnalyticsChannelAffinityRankFilter
object
3 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

klaviyo-segments-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 Custom Objects API
Klaviyo Data Privacy API
Klaviyo Events API
Klaviyo Flows API
Klaviyo Forms API
Klaviyo Images API
Where this information came from

This is an independent, third-party profile of Klaviyo Segments API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.