HomeGuidesAPI Reference
ChangelogHelp CenterCommunityContact Us
API Reference

Create Location

🚧

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.

Create a physical location.

The location has to be placeable on a map: supply either address1, or both city and region, or both latitude and longitude. Klaviyo geocodes whatever is supplied and fills in the remaining address fields it can resolve, so latitude and longitude may be absent from the response until geocoding finishes — check geocode_status.

Rate limits:
Burst: 10/s
Steady: 150/m

Scopes:
locations:write

OpenAPI Spec

Query Params
fields[location]
array of strings
fields[location]
include
array of strings
include
Allowed:
Body Params

Request to create a location.

A location must be placeable on a map, so the request has to carry either an address or a coordinate pair: a non-empty address1, or both city and region, or both latitude and longitude. Whatever is supplied is geocoded, and the fields it can resolve are filled in on the created resource.

data
object
required
Headers
string
required
Defaults to 2026-10-15.pre

API endpoint revision (format: YYYY-MM-DD[.suffix])

Responses

Language
Credentials
Header
LoadingLoading…
Response
Choose an example:
application/vnd.api+json