HomeGuidesAPI Reference
ChangelogHelp CenterCommunityContact Us
API Reference

Create Profile

Create a new profile.

Use the additional-fields parameter to include subscriptions and predictive analytics data in your response.

Rate limits:
Burst: 75/s
Steady: 700/m

Scopes:
profiles:write

Query Params
array of strings

Request additional fields not included by default in the response. Supported values: 'subscriptions', 'predictive_analytics'

additional-fields[profile]
Body Params
object
required
string
required
object
required
string

Individual's email address

string

Individual's phone number in E.164 format

string

A unique identifier used by customers to associate Klaviyo profiles with profiles in an external system, such as a point-of-sale system. Format varies based on the external system.

string

Individual's first name

string

Individual's last name

string

Name of the company or organization within the company for whom the individual works

string

The locale of the profile, in the IETF BCP 47 language tag format like (ISO 639-1/2)-(ISO 3166 alpha-2)

string

Individual's job title

string

URL pointing to the location of a profile image

object
string

First line of street address

string

Second line of street address

string

City name

string

Country name

Latitude coordinate. We recommend providing a precision of four decimal places.

Longitude coordinate. We recommend providing a precision of four decimal places.

string

Region within a country, such as state or province

string

Zip code

string

Time zone name. We recommend using time zones from the IANA Time Zone Database.

string

IP Address

object

An object containing key/value pairs for any custom properties assigned to this profile

string
Headers
string
required
Defaults to 2025-01-15

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

Responses

Language
Credentials