Create or Update Push Token

POST {{baseUrl}}/api/push-tokens/

Create or update a push token.

This endpoint can be used to migrate push tokens from another platform to Klaviyo. Please use our mobile SDKs (iOS and Android) to create push tokens from users' devices.

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

Scopes: profiles:write push-tokens:write

Request Body

{"data"=>{"type"=>"push-token", "attributes"=>{"token"=>"<string>", "platform"=>"android", "vendor"=>"fcm", "profile"=>{"data"=>{"type"=>"profile", "attributes"=>{"email"=>"<string>", "phone_number"=>"<string>", "external_id"=>"<string>", "anonymous_id"=>"<string>", "_kx"=>"<string>", "first_name"=>"<string>", "last_name"=>"<string>", "organization"=>"<string>", "title"=>"<string>", "image"=>"<string>", "location"=>{"address1"=>"<string>", "address2"=>"<string>", "city"=>"<string>", "country"=>"<string>", "latitude"=>"<string>", "longitude"=>"<string>", "region"=>"<string>", "zip"=>"<string>", "timezone"=>"<string>", "ip"=>"<string>"}, "meta"=>{"patch_properties"=>{"unset"=>"<string>"}}}, "id"=>"<string>"}}, "enablement_status"=>"AUTHORIZED", "background"=>"AVAILABLE", "device_metadata"=>{"device_id"=>"<string>", "klaviyo_sdk"=>"android", "sdk_version"=>"<string>", "device_model"=>"<string>", "os_name"=>"ipados", "os_version"=>"<string>", "manufacturer"=>"<string>", "app_name"=>"<string>", "app_version"=>"<string>", "app_build"=>"<string>", "app_id"=>"<string>", "environment"=>"release"}}}}

HEADERS

KeyDatatypeRequiredDescription
revisionstring(Required) API endpoint revision (format: YYYY-MM-DD[.suffix])
Content-Typestring
Acceptstring