🚧

This endpoint is in beta and subject to change.

A beta revision header (2026-10-15.pre) is required to use our beta APIs. Klaviyo APIs in beta are not intended for use in production. See our versioning and deprecation policy for more information.

Link existing segments to a location.

Segments already linked to this location are left alone, so sending the same request twice changes nothing. A segment linked to a different location moves to this one.

To create a new segment first, use POST /api/segments.

Rate limits:
Burst: 3/s
Steady: 60/m

Scopes:
locations:write
segments:write

OpenAPI Spec