HomeGuidesAPI Reference
ChangelogHelp CenterCommunityContact Us
API Reference

Create Back In Stock Subscription

Subscribe a profile to receive back in stock notifications. Check out our Back in Stock API guide for more details.

This endpoint is specifically designed to be called from server-side applications. To create subscriptions from client-side contexts, use POST /client/back-in-stock-subscriptions.

Rate limits:
Burst: 350/s
Steady: 3500/m

Scopes:
catalogs:write
profiles:write

Body Params
object
required
string
required
object
required
array of strings
required

The channel(s) through which the profile would like to receive the back in stock notification. This can be leveraged within a back in stock flow to notify the subscriber through their preferred channel(s).

channels*
object
object
required
string
required
string

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

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
object
required
object
required
object
string
required
string
required

The catalog variant ID for which the profile is subscribing to back in stock notifications. This ID is made up of the integration type, catalog ID, and and the external ID of the variant like so: integrationType:::catalogId:::externalId. If the integration you are using is not set up for multi-catalog storage, the 'catalogId' will be $default. For Shopify $shopify:::$default:::33001893429341

Headers
string
required
Defaults to 2025-01-15

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

Responses
202

Success

Language
Credentials