HomeGuidesAPI Reference
ChangelogHelp CenterCommunityContact Us
API Reference
These docs are for a deprecated API version. Click here to use the latest version.

Create Profile

Create a new profile.
If you use a phone number as the profile identifier and SMS is not set up in the Klaviyo account, you'll need to include at least one other identifier attribute (email or external_id) in addition to the phone_number attribute for the API call to work.

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

Scopes:
Profiles Write

Body Params
object
required
string
required
object
required
string
Defaults to sarah.mason@klaviyo-demo.com

Individual's email address

string
Defaults to +15005550006

Individual's phone number in E.164 format

string
Defaults to 63f64a2b-c6bf-40c7-b81f-bed08162edbe

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
Defaults to Sarah

Individual's first name

string
Defaults to Mason

Individual's last name

string
Defaults to Klaviyo

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

string
Defaults to Engineer

Individual's job title

string
Defaults to https://images.pexels.com/photos/3760854/pexels-photo-3760854.jpeg

URL pointing to the location of a profile image

object
string
Defaults to 89 E 42nd St

First line of street address

string
Defaults to 1st floor

Second line of street address

string
Defaults to New York

City name

string
Defaults to United States

Country name

Defaults to 40.7128

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

Defaults to 74.0060

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

string
Defaults to NY

Region within a country, such as state or province

string
Defaults to 10017

Zip code

string
Defaults to America/New_York

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

object

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

string
Headers
string
required
Defaults to 2023-01-24

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

Responses

Language
Credentials