HomeGuidesAPI Reference
ChangelogHelp CenterCommunityContact Us
API Reference

Create or Update Client Push Token

Create or update a push token.

This endpoint is designed to be called from our mobile SDKs (iOS and Android).
You must have push notifications enabled to use this endpoint.

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

Query Params
string
required
Defaults to PUBLIC_API_KEY

Your Public API Key / Site ID. See this article for more details.

Body Params
object
required
string
required
object
required
string
required
Defaults to 1234567890

A push token from APNS or FCM.

string
required

The platform on which the push token was created.

string
Defaults to AUTHORIZED

This is the enablement status for the individual push token.

string
required
Defaults to APNs

The vendor of the push token.

string
Defaults to AVAILABLE

The background state of the push token.

object

Metadata about the device that created the push token

string
Defaults to 1234567890

Relatively stable ID for the device. Will update on app uninstall and reinstall

string
Defaults to swift

The name of the SDK used to create the push token.

string
Defaults to 1.0.0

The version of the SDK used to create the push token

string
Defaults to iPhone12,1

The model of the device

string
Defaults to ios

The name of the operating system on the device.

string
Defaults to 14.0

The version of the operating system on the device

string
Defaults to Apple

The manufacturer of the device

string
Defaults to Klaviyo

The name of the app that created the push token

string
Defaults to 1.0.0

The version of the app that created the push token

string
Defaults to 1

The build of the app that created the push token

string
Defaults to com.klaviyo.app

The ID of the app that created the push token

string
Defaults to release

The environment in which the push token was created

object
required

The profile associated with the push token to create/update

object
required
string
required
string
Defaults to 01GDDKASAP8TKDDA2GRZDSVP4H

Primary key that uniquely identifies this profile. Generated by Klaviyo.

object
required
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 01GDDKASAP8TKDDA2GRZDSVP4H

Id that can be used to identify a profile when other identifiers are not available

string
Defaults to J8fjcn003Wy6b-3ILNlOyZXabW6dcFwTyeuxrowMers%3D.McN66

Also known as the exchange_id, this is an encrypted identifier used for identifying a
profile by Klaviyo's web tracking.

You can use this field as a filter when retrieving profiles via the Get Profiles endpoint.

string
Defaults to Sarah

Individual's first name

string
Defaults to Mason

Individual's last name

string
Defaults to Example Corporation

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

string
Defaults to Regional Manager

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.

string
Defaults to 127.0.0.1

IP Address

object

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

string
object
object

Specify one or more patch operations to apply to existing property data

object

Append a simple value or values to this property array

string
object

Remove a simple value or values from this property array

string
string
Defaults to skus

Remove a key or keys (and their values) completely from properties

string
Defaults to sarah.mason@klaviyo-demo.com

Individual's email address

Headers
string
required
Defaults to 2024-02-15

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

Responses
202

Success

Language