npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

klaviyo-api

v15.0.0

Published

A typescript client for the Klaviyo API

Downloads

120,859

Readme

Klaviyo Typescript SDK

  • SDK version: 15.0.0

  • Revision: 2024-10-15

Helpful Resources

Other Klaviyo Resources

Design & Approach

This SDK is a thin wrapper around our API. See our API Reference for full documentation on API behavior.

This SDK exactly mirrors the organization and naming convention of the above language-agnostic resources, with a few namespace changes to make it fit better with Typescript

Organization

This SDK is organized into the following resources:

  • AccountsApi
  • CampaignsApi
  • CatalogsApi
  • CouponsApi
  • DataPrivacyApi
  • EventsApi
  • FlowsApi
  • FormsApi
  • ImagesApi
  • ListsApi
  • MetricsApi
  • ProfilesApi
  • ReportingApi
  • ReviewsApi
  • SegmentsApi
  • TagsApi
  • TemplatesApi
  • TrackingSettingsApi
  • WebhooksApi

Installation

NPM

You can install this library using npm.

npm install [email protected]

source code

Alternatively, you can also run this using this repo as source code, simply download this repo then connect to your app putting the path in your package.json or via npm link

path: add this line to your apps package.json

"klaviyo-api": "< path to downloaded source code >"

npm link:

run npm link in your local copy of this repo's directory

run npm link <"path to this repo"> first in your consuming app's directory

Sample file:

If you want to test out the repo but don't have a consuming app, you can run our sample typescript file, make whatever edits you want to sample.ts in the sample folder and use

npm run sample --pk=<YOUR PRIVATE KEY HERE>

Usage Example

To instantiate an API wrapper using an API Key

import { ApiKeySession, ProfilesApi } from 'klaviyo-api'

const session = new ApiKeySession("< YOUR API KEY HERE >")
const profilesApi = new ProfilesApi(session)

To call the createProfile operation:

import {
  ApiKeySession,
  ProfileCreateQuery,
  ProfileEnum,
  ProfilesApi,
} from 'klaviyo-api'

const session = new ApiKeySession("< YOUR API KEY HERE >")
const profilesApi = new ProfilesApi(session)

let profile: ProfileCreateQuery = {
  data: {
  type: ProfileEnum.Profile,
  attributes: {
    email: "[email protected]"
    }
  }
}


profilesApi.createProfile(profile).then(result => {
  console.log(result)
}).catch(error => {
  console.log(error)
});

Retry Options

Constructing an API object also has optional property RetryWithExponentialBackoff, which attempts retries on failed API calls with exponential backoff.

The default configs are:

  • retryCodes: [429, 503, 504, 524]
  • numRetries: 3
  • maxInterval: 60
const retryWithExponentialBackoff: RetryWithExponentialBackoff = new RetryWithExponentialBackoff({ retryCodes: [429, 503, 504, 524], numRetries: 3, maxInterval: 60})
const session = new ApiKeySession("< YOUR API KEY HERE >", retryWithExponentialBackoff)

Organizational Helpers

There is also an optional Klaviyo import that has all the Apis and Auth, if you prefer that method for organization.

import { Klaviyo } from 'klaviyo-api'

const profilesApi = new Klaviyo.ProfilesApi(new Klaviyo.Auth.ApiKeySession("< YOUR API KEY HERE >", retry))

Inspecting Errors

Failed api calls throw an AxiosError.

The two most commonly useful error items are probably - error.response.status - error.response.statusText

Here is an example of logging those errors to the console

profilesApi.createProfile(profile).then(result => {
  console.log(result.body)
}).catch(error => {
  console.log(error.response.status)
  console.log(error.response.statusText)
});

Uploading an image by file

The ImageApi exposes uploadImageFromFile()

import fs from 'fs'
import {ApiKeySession, ImageApi } from 'klaviyo-api'

const session = new ApiKeySession("< YOUR API KEY HERE >")
const imageApi = new ImagesApi(session)
imageApi.uploadImageFromFile(fs.createReadStream("./test_image.jpeg")).then(result => {
    console.log(result.body)
}).catch(error => {
  console.log(error)
}

Global Api Key

If you only connect to one Klaviyo account you may find it useful to access preconfigured objects.

Set a global key, If you were using ConfigWrapper this also sets the GlobalApiKeySettings

import { GlobalApiKeySettings } from 'klaviyo-api'

new GlobalApiKeySettings("< YOUR API KEY HERE >")

Now you can use the shortened names ProfilesApi can be referenced with Profiles

import { Profiles, GlobalApiKeySettings } from 'klaviyo-api'

new GlobalApiKeySettings("< YOUR API KEY HERE >")

Profiles.getProfiles().then(result => {
  console.log(result.body)
}).catch(error => {
  console.log(error.response.status)
  console.log(error.response.statusText)
});

Using OAuth to connect to multiple Klaviyo accounts.

For users creating integrations or managing multiple Klaviyo accounts, Klaviyo's OAuth authentication will make these tasks easier.

Getting started with OAuth

First, configure an integration. If you haven't set up an integration, learn about it in this guide

Making API Calls with OAuth

The klaviyo-api package can keep your access token up to date. If you have already developed a system for refreshing tokens or would like a more minimalist option, skip to OAuthBasicSession

TokenStorage

For the OAuthApi to be storage agnostic, this interface must be implemented for the OAuthApi to retrieve and save you access and refresh tokens. Implement the retrieve and save functions outlined in the interface. If you need help getting started, check out the storageHelpers.ts in the Klaviyo Example Typescript Integration

Your implementation needs to include two methods:

  1. save is called after creating a new access token via the authorization flow or after refreshing the access token. Your code needs to update (and insert if you are going to be using createTokens()) the new access or refresh token information into storage to keep track of which of your integration users' access information you are referencing, the customerIdentifier is a unique value to help with lookup later.
    save(customerIdentifier: string, tokens: CreatedTokens): Promise<void> | void
  2. retrieve leverages the customerIdentifier to look up the saved token information and returns it for the OAuthApi to use
    retrieve(customerIdentifier: string): Promise<RetrievedTokens> | RetrievedTokens
import { TokenStorage } from 'klaviyo-api';
class <Your Token Storage Class Name Here> implements TokenStorage

OAuthApi

This class holds the information about your specific integration. It takes three inputs:

  1. clientId - This is the id of your integration. Retrieve it from your integration's settings page
  2. clientSecret - This is the secret for your integration. The secret is generated upon the creation of your integration.
  3. tokenStorage - This is an instance of your implementation of TokenStorage and is called automatically when creating and refreshing access tokens
import { OAuthApi } from 'klaviyo-api';

const oauthApi = new OAuthApi("<client id>", "<client secret>", <instance of your TokenStorage implimentation>)

OAuthSession

To make an API call, you need to create an OAuthSession instance. This session object is the OAuth equivalent of ApiKeySession and is used similarly.

It takes two properties

  1. customerIdentifier - This is how the session is going to grab a user's authentication information and let your implementation of TokenStorage know where to save any update access token
  2. oauthApi - This is the instance of OAuthApi created above. It will dictate how the session saves and retrieves the access tokens
  3. retryWithExponentialBackoff - OPTIONAL - the RetryWithExponentialBackoff instance outlines your desired exponential backoff configs, outlined in Retry Options above
import { OAuthSession, ProfilesApi } from 'klaviyo-api';

const session = new OAuthSession(customerIdentifier, oauthApi)

//Pass the session into the API you want to use
const profileApi = new ProfilesApi(session)

OAuthBasicSession

If you don't want to deal with any of the helpers above or don't want klaviyo-api to refresh your tokens for you, this is the alternative.

The OAuthBasicSession takes up to two parameters

  1. accessToken - The token is used in the API calls' authentication
  2. retryWithExponentialBackoff - OPTIONAL - the RetryWithExponentialBackoff instance outlines your desired exponential backoff configs, outlined in Retry Options above
import { OAuthBasicSession } from 'klaviyo-api';

const session = new OAuthBasicSession("<access token>")

//Pass the session into the API you want to use
const profileApi = new ProfilesApi(session)

Remember to check for 401 errors. A 401 means that your token is probably expired.

KlaviyoTokenError

If an error occurred during an API call, check the error type with isKlaviyoTokenError. The name property will reflect which step the error occurred, reflecting whether it happened during creating, refreshing, saving, or retrieving the name tokens. The cause property will hold the error object of whatever specific error occurred.

Authorization Flow

Build The authorization flow in the same application as with the rest of your integrations business logic or separately. There is no requirement that the authorization flow has to be backend and can be implemented entirely in a frontend application (in that case, you can ignore this section, as this repo shouldn't use this for frontend code)

To understand the authorization flow, there are two major resources to help:

  1. OAuth authorization guide
  2. Node Integration Example

If you implement your authorization flow on a node server, you can use these exposed helper functions.

OAuthApi

The OAuthApi class also exposes helpful Authorization flow utilities.

  1. generateAuthorizeUrl - This helps correctly format the Klaviyo /oauth/authorize URL the application needs to redirect to so a user can approve your integration.

    1. state - This is the only way to identify which user just authorized your application (or failed to). state is passed back via query parameter to your redirectUrl.
    2. scope - The permissions the created access tokens will have. The user will be displayed these scopes during the authorization flow. For these permissions to work, also add them to your app settings in Klaviyo here
    3. codeChallenge - This is the value generated above by the generateCode function.
    4. redirectUrl - This is the URL that Klaviyo will redirect the user to once Authorization is completed (even if it is denied or has an error). Remember to whitelist this redirect URL in your integration's settings in Klaviyo.
     import { OAuthApi } from 'klaviyo-api'
    
     const oauthApi = new OAuthApi("<client id>", "<client secret>", <TokenStorage implementation instance>)
     oauthApi.generateAuthorizeUrl(
       state, // It's suggested to use your internal identifier for the Klaviyo account that is authorizing
       scopes,
       codeChallenge,
       redirectUrl
     )
  2. createTokens - Uses Klaviyo /oauth/token/ endpoint to create access and refresh tokens

    1. customerIdentifier - This ID is NOT sent to Klaviyo's API. If the /token API call this method wraps is successful, the created tokens will be passed into your save method along with this customerIdentifier in your implementation of TokenStorage.
    2. codeVerifier - The verifier code must match the challenge code in the authorized URL redirect.
    3. authorizationCode- A User approving your integration creates this temporary authorization code. Your specified redirect URL receives this under a code query parameter.
    4. redirectUrl - The endpoint set in generateAuthorizeUrl. Whitelist the URL in your application settings.
     import { OAuthApi } from 'klaviyo-api'
    
     const oauthApi = new OAuthApi("<client id>", "<client secret>", <TokenStorage implementation instance>)
     await oauthApi.createTokens(
       customerIdentifier,
       codeVerifier,
       authorizationCode,
       redirectUrl
     )
  3. OAuthCallbackQueryParams For typescript users, this object is an interface representing the possible query parameters sent to your redirect endpoint

Proof Key of Code Exchange (PKCE)

All the PKCE helper functions live within the Pkce namespace. Read about PKCE here

import { Pkce } from 'klaviyo-api'

The Pkce namespace holds two different helper utilities

  1. generateCodes - This method will create the codeVerifier and codeChallenge needed later in the authorization flow.

    import { Pkce } from 'klaviyo-api'
    
    const pkceCodes = new Pkce.generateCodes()
    // the two codes can be accessed by
    const codeVerifier: string = pkceCodes.codeVerifier
    const codeChallenge: string = pkceCodes.codeChallenge
  2. CodeStorage - This is an OPTIONAL interface to help keep your code organized, to relate a customerIdentifier to their generated PKCE code

    import { Pkce } from 'klaviyo-api'
    class <Your Code Storage Class Here> implements Pkce.CodeStorage

Optional Parameters and JSON:API features

Here we will go over

  • Pagination
  • Page size
  • Additional Fields
  • Filtering
  • Sparse Fields
  • Sorting
  • Relationships

Quick rule

As a reminder, some optional parameters are named slightly differently from how you would make the call without the SDK docs; the reason for this is that some query parameter names have variables that make for bad JavaScript names. For example: page[cursor] becomes pageCursor. (In short: remove the non-allowed characters and append words with camelCase).

Cursor based Pagination

All the endpoints that return a list of results use cursor-based pagination.

Obtain the cursor value from the call you want to get the next page for, then pass it under the pageCursor optional parameter. The page cursor looks like WzE2NDA5OTUyMDAsICIzYzRjeXdGTndadyIsIHRydWVd.

API call:

https://a.klaviyo.com/api/profiles/?page[cursor]=WzE2NTcyMTM4NjQsICIzc042NjRyeHo0ciIsIHRydWVd

SDK call:

import { ApiKeySession, ProfilesApi } from 'klaviyo-api'

const session = new ApiKeySession("< YOUR API KEY HERE >")
const profilesApi = new ProfilesApi(session)

const profileList = await profilesApi.getProfiles({pageCursor: 'WzE2NTcyMTM4NjQsICIzc042NjRyeHo0ciIsIHRydWVd'})

You get the cursor for the next page from body.link.next. This returns the entire url of the next call, but the SDK will accept the entire link and use only the relevant cursor, so no need to do any parsing of the next link on your end

Here is an example of getting the second next and passing in the page cursor:

import { ApiKeySession, ProfilesApi } from 'klaviyo-api'

const session = new ApiKeySession("< YOUR API KEY HERE >")
const profilesApi = new ProfilesApi(session)

try {
    const profilesListFirstPage = await profilesApi.getProfiles()
    const nextPage = profilesListFirstPage.body.links.next
    const profileListSecondPage = await profilesApi.getProfiles({pageCursor: nextPage})
    console.log(profileListSecondPage.body)
} catch (e) {
    console.log(e)
}

There are more page cursors than just next: first, last, next and prev. Check the API Reference for all the paging params for a given endpoint.

Page Size

Some endpoints allow you to set the page size by using the pageSize parameter.

API call:

https://a.klaviyo.com/api/profiles/?page[size]=20

SDK call:

import { ApiKeySession, ProfilesApi } from 'klaviyo-api'

const session = new ApiKeySession("< YOUR API KEY HERE >")
const profilesApi = new ProfilesApi(session)

const profileList = await profilesApi.getProfiles({pageSize: 20})

Additional Fields

Additional fields are used to populate parts of the response that would be null otherwise. For example, for the getProfile, endpoint you can pass in a request to get the predictive analytics of the profile. Using the additionalFields parameter does impact the rate limit of the endpoint in cases where the related resource is subject to a lower rate limit, so be sure to keep an eye on your usage. API call:

https://a.klaviyo.com/api/profiles/01GDDKASAP8TKDDA2GRZDSVP4H/?additional-fields[profile]=predictive_analytics

SDK call:

import { ApiKeySession, ProfilesApi } from 'klaviyo-api'

const session = new ApiKeySession("< YOUR API KEY HERE >")
const profilesApi = new ProfilesApi(session)

const profileId = '01GDDKASAP8TKDDA2GRZDSVP4H'
const profile = await profilesApi.getProfile(profileId, {additionalFieldsProfile: ['predictive_analytics']})

// If your profile has enough information for predictive analytis it will populate
console.log(profile.body.data.attributes.predictiveAnalytics)

Filtering

You can filter responses by passing a string into the optional parameter filter. Note that when filtering by a property it will be snake_case instead of camelCase, ie. metric_id

Read more about formatting your filter strings in our developer documentation

Here is an example of a filter string for results between two date times: less-than(updated,2023-04-26T00:00:00Z),greater-than(updated,2023-04-19T00:00:00Z)

Here is a code example to filter for profiles with the matching emails:

https://a.klaviyo.com/api/profiles/?filter=any(email,["[email protected]","[email protected]"]

SDK call:

import { ApiKeySession, ProfilesApi } from 'klaviyo-api'

const session = new ApiKeySession("< YOUR API KEY HERE >")
const profilesApi = new ProfilesApi(session)

const filter = 'any(email,["[email protected]","[email protected]"])'
const profileList = await profilesApi.getProfiles({filter})

To help create filters in the correct format, use the FilterBuilder class

new FilterBuilder()
      .equals("email", "[email protected]")
      .build() // outputs equals(email,"[email protected]")

Complex filters can be build by adding additional filters to the builder before calling build()

const date = new Date(2023, 7, 15, 12, 30, 0);
new FilterBuilder()
      .any("email", ["[email protected]", "[email protected]"])
      .greaterThan("created", date)
      .build();
// outputs any(email,["[email protected]","[email protected]"]),greater-than(created,2023-08-15T16:30:00.000Z)

Sparse Fields

If you only want a specific subset of data from a specific query you can use sparse fields to request only the specific properties. The SDK expands the optional sparse fields into their own option, where you can pass a list of the desired items to include.

To get a list of event properties the API call you would use is:

https://a.klaviyo.com/api/events/?fields[event]=event_properties

SDK call:

import { ApiKeySession, EventsApi } from 'klaviyo-api'

const session = new ApiKeySession("< YOUR API KEY HERE >")
const eventsApi = new EventsApi(session)

const eventsList = await eventsApi.getEvents({fieldsEvent: ["event_properties"]})

Sorting

Your can request the results of specific endpoints to be ordered by a given parameter. The direction of the sort can be reversed by adding a - in front of the sort key. For example datetime will be ascending while -datetime will be descending.

If you are unsure about the available sort fields, refer to the API Reference page for the endpoint you are using. For a comprehensive list that links to the documentation for each function check the Endpoints section below.

API Call to get events sorted by oldest to newest datetime:

https://a.klaviyo.com/api/events/?sort=-datetime

SDK call:

import { ApiKeySession, EventsApi } from 'klaviyo-api'

const session = new ApiKeySession("< YOUR API KEY HERE >")
const eventsApi = new EventsApi(session)

const events = await eventsApi.getEvents({sort: '-datetime'})

Includes

You can add additional information to your API response via additional fields and the includes parameter. This allows you to get information about two or more objects from a single API call. Using the includes parameter often changes the rate limit of the endpoint so be sure to take note.

API call to get profile information and the information about the lists the profile is in:

https://a.klaviyo.com/api/profiles/01GDDKASAP8TKDDA2GRZDSVP4H/?include=lists

SDK call:

import { ApiKeySession, ProfilesApi } from 'klaviyo-api'

const session = new ApiKeySession("< YOUR API KEY HERE >")
const profilesApi = new ProfilesApi(session)

const profileId = '01GDDKASAP8TKDDA2GRZDSVP4H'
const profile = await profilesApi.getProfile(profileId,{include:["lists"]})

// Profile information is accessed the same way with
console.log(profile.body.data)
// Lists related to the profile with be accessible via the included array
console.log(profile.body.included)

Note about sparse fields and relationships: you can also request only specific fields for the included object as well.

import { ApiKeySession, ProfilesApi } from 'klaviyo-api'

const session = new ApiKeySession("< YOUR API KEY HERE >")
const profilesApi = new ProfilesApi(session)

const profileId = '01GDDKASAP8TKDDA2GRZDSVP4H'
// Use the fieldsLists property to request only the list name
const profile = await profilesApi.getProfile(profileId, {fieldsList: ['name'], include: ["lists"]})

// Profile information is accessed the same way with
console.log(profile.body.data)
// Lists related to the profile with be accessible via the included array
console.log(profile.body.included)

Relationships

The Klaviyo API has a series of endpoints to expose the relationships between different Klaviyo Items. You can read more about relationships in our documentation.

Here are some use cases and their examples:

API call to get the list membership for a profile with the given profile ID:

https://a.klaviyo.com/api/profiles/01GDDKASAP8TKDDA2GRZDSVP4H/relationships/lists/

SDK call:

import { ApiKeySession, ProfilesApi } from 'klaviyo-api'

const session = new ApiKeySession("< YOUR API KEY HERE >")
const profilesApi = new ProfilesApi(session)

const profileId = '01GDDKASAP8TKDDA2GRZDSVP4H'
const profileRelationships = await profilesApi.getProfileRelationshipsLists(profileId)

For another example:

Get all campaigns associated with the given tag_id.

API call:

https://a.klaviyo.com/api/tags/9c8db7a0-5ab5-4e3c-9a37-a3224fd14382/relationships/campaigns/

SDK call:

import { ApiKeySession, TagsApi } from 'klaviyo-api'

const session = new ApiKeySession("< YOUR API KEY HERE >")
const tagsApi = new TagsApi(session)

const tagId = '9c8db7a0-5ab5-4e3c-9a37-a3224fd14382'
const relatedCampagins = tagsApi.getTagRelationshipsCampaigns(tagId)

Combining

You can use any combination of the features outlines above in conjunction with one another.

API call to get events associated with a specific metric, then return just the event properties sorted by oldest to newest datetime:

API call:

https://a.klaviyo.com/api/events/?fields[event]=event_properties&filter=equals(metric_id,"URDbLg")&sort=-datetime

SDK call:

import { ApiKeySession, EventsApi } from 'klaviyo-api'

const session = new ApiKeySession("< YOUR API KEY HERE >")
const eventsApi = new EventsApi(session)

const metricId = 'URDbLg'
const filter = `equal(metric_id,"${metricId}")`
const events = await eventsApi.getEvents({fieldsEvent: ['event_properties'], sort: '-datetime', filter})

Endpoints

AccountsApi


Get Account

AccountsApi.getAccount(id: string, options)

Get Accounts

AccountsApi.getAccounts(options)

CampaignsApi


Assign Template to Campaign Message

CampaignsApi.assignTemplateToCampaignMessage(campaignMessageAssignTemplateQuery: CampaignMessageAssignTemplateQuery)
Method alias:
CampaignsApi.createCampaignMessageAssignTemplate(campaignMessageAssignTemplateQuery: CampaignMessageAssignTemplateQuery)

Cancel Campaign Send

CampaignsApi.cancelCampaignSend(id: string, campaignSendJobPartialUpdateQuery: CampaignSendJobPartialUpdateQuery)
Method alias:
CampaignsApi.updateCampaignSendJob(id: string, campaignSendJobPartialUpdateQuery: CampaignSendJobPartialUpdateQuery)

Create Campaign

CampaignsApi.createCampaign(campaignCreateQuery: CampaignCreateQuery)

Create Campaign Clone

CampaignsApi.createCampaignClone(campaignCloneQuery: CampaignCloneQuery)
Method alias:
CampaignsApi.cloneCampaign(campaignCloneQuery: CampaignCloneQuery)

Delete Campaign

CampaignsApi.deleteCampaign(id: string)

Get Campaign

CampaignsApi.getCampaign(id: string, options)

Get Campaign for Campaign Message

CampaignsApi.getCampaignForCampaignMessage(id: string, options)
Method alias:
CampaignsApi.getCampaignMessageCampaign(id: string, options)

Get Campaign ID for Campaign Message

CampaignsApi.getCampaignIdForCampaignMessage(id: string)
Method alias:
CampaignsApi.getCampaignMessageRelationshipsCampaign(id: string)

Get Campaign Message

CampaignsApi.getCampaignMessage(id: string, options)

Get Campaign Recipient Estimation

CampaignsApi.getCampaignRecipientEstimation(id: string, options)

Get Campaign Recipient Estimation Job

CampaignsApi.getCampaignRecipientEstimationJob(id: string, options)

Get Campaign Send Job

CampaignsApi.getCampaignSendJob(id: string, options)

Get Campaign Tags

CampaignsApi.getCampaignTags(id: string, options)
Method alias:
CampaignsApi.getTagsForCampaign(id: string, options)

Get Campaigns

CampaignsApi.getCampaigns(filter: string, options)

Get Message IDs for Campaign

CampaignsApi.getMessageIdsForCampaign(id: string)
Method alias:
CampaignsApi.getCampaignRelationshipsCampaignMessages(id: string)
Method alias:
CampaignsApi.getCampaignRelationshipsMessages(id: string)

Get Messages for Campaign

CampaignsApi.getMessagesForCampaign(id: string, options)
Method alias:
CampaignsApi.getCampaignCampaignMessages(id: string, options)
Method alias:
CampaignsApi.getCampaignMessages(id: string, options)

Get Tag IDs for Campaign

CampaignsApi.getTagIdsForCampaign(id: string)
Method alias:
CampaignsApi.getCampaignRelationshipsTags(id: string)

Get Template for Campaign Message

CampaignsApi.getTemplateForCampaignMessage(id: string, options)
Method alias:
CampaignsApi.getCampaignMessageTemplate(id: string, options)

Get Template ID for Campaign Message

CampaignsApi.getTemplateIdForCampaignMessage(id: string)
Method alias:
CampaignsApi.getCampaignMessageRelationshipsTemplate(id: string)

Refresh Campaign Recipient Estimation

CampaignsApi.refreshCampaignRecipientEstimation(campaignRecipientEstimationJobCreateQuery: CampaignRecipientEstimationJobCreateQuery)
Method alias:
CampaignsApi.createCampaignRecipientEstimationJob(campaignRecipientEstimationJobCreateQuery: CampaignRecipientEstimationJobCreateQuery)

Send Campaign

CampaignsApi.sendCampaign(campaignSendJobCreateQuery: CampaignSendJobCreateQuery)
Method alias:
CampaignsApi.createCampaignSendJob(campaignSendJobCreateQuery: CampaignSendJobCreateQuery)

Update Campaign

CampaignsApi.updateCampaign(id: string, campaignPartialUpdateQuery: CampaignPartialUpdateQuery)

Update Campaign Message

CampaignsApi.updateCampaignMessage(id: string, campaignMessagePartialUpdateQuery: CampaignMessagePartialUpdateQuery)

CatalogsApi


Add Categories to Catalog Item

CatalogsApi.addCategoriesToCatalogItem(id: string, catalogItemCategoryOp: CatalogItemCategoryOp)
Method alias:
CatalogsApi.addCategoryToCatalogItem(id: string, catalogItemCategoryOp: CatalogItemCategoryOp)
Method alias:
CatalogsApi.createCatalogItemRelationshipsCategory(id: string, catalogItemCategoryOp: CatalogItemCategoryOp)
Method alias:
CatalogsApi.createCatalogItemRelationshipsCategories(id: string, catalogItemCategoryOp: CatalogItemCategoryOp)

Add Items to Catalog Category

CatalogsApi.addItemsToCatalogCategory(id: string, catalogCategoryItemOp: CatalogCategoryItemOp)
Method alias:
CatalogsApi.createCatalogCategoryRelationshipsItem(id: string, catalogCategoryItemOp: CatalogCategoryItemOp)
Method alias:
CatalogsApi.createCatalogCategoryRelationshipsItems(id: string, catalogCategoryItemOp: CatalogCategoryItemOp)

Bulk Create Catalog Categories

CatalogsApi.bulkCreateCatalogCategories(catalogCategoryCreateJobCreateQuery: CatalogCategoryCreateJobCreateQuery)
Method alias:
CatalogsApi.spawnCreateCategoriesJob(catalogCategoryCreateJobCreateQuery: CatalogCategoryCreateJobCreateQuery)
Method alias:
CatalogsApi.createCatalogCategoryBulkCreateJob(catalogCategoryCreateJobCreateQuery: CatalogCategoryCreateJobCreateQuery)

Bulk Create Catalog Items

CatalogsApi.bulkCreateCatalogItems(catalogItemCreateJobCreateQuery: CatalogItemCreateJobCreateQuery)
Method alias:
CatalogsApi.spawnCreateItemsJob(catalogItemCreateJobCreateQuery: CatalogItemCreateJobCreateQuery)
Method alias:
CatalogsApi.createCatalogItemBulkCreateJob(catalogItemCreateJobCreateQuery: CatalogItemCreateJobCreateQuery)

Bulk Create Catalog Variants

CatalogsApi.bulkCreateCatalogVariants(catalogVariantCreateJobCreateQuery: CatalogVariantCreateJobCreateQuery)
Method alias:
CatalogsApi.spawnCreateVariantsJob(catalogVariantCreateJobCreateQuery: CatalogVariantCreateJobCreateQuery)
Method alias:
CatalogsApi.createCatalogVariantBulkCreateJob(catalogVariantCreateJobCreateQuery: CatalogVariantCreateJobCreateQuery)

Bulk Delete Catalog Categories

CatalogsApi.bulkDeleteCatalogCategories(catalogCategoryDeleteJobCreateQuery: CatalogCategoryDeleteJobCreateQuery)
Method alias:
CatalogsApi.spawnDeleteCategoriesJob(catalogCategoryDeleteJobCreateQuery: CatalogCategoryDeleteJobCreateQuery)
Method alias:
CatalogsApi.createCatalogCategoryBulkDeleteJob(catalogCategoryDeleteJobCreateQuery: CatalogCategoryDeleteJobCreateQuery)

Bulk Delete Catalog Items

CatalogsApi.bulkDeleteCatalogItems(catalogItemDeleteJobCreateQuery: CatalogItemDeleteJobCreateQuery)
Method alias:
CatalogsApi.spawnDeleteItemsJob(catalogItemDeleteJobCreateQuery: CatalogItemDeleteJobCreateQuery)
Method alias:
CatalogsApi.createCatalogItemBulkDeleteJob(catalogItemDeleteJobCreateQuery: CatalogItemDeleteJobCreateQuery)

Bulk Delete Catalog Variants

CatalogsApi.bulkDeleteCatalogVariants(catalogVariantDeleteJobCreateQuery: CatalogVariantDeleteJobCreateQuery)
Method alias:
CatalogsApi.spawnDeleteVariantsJob(catalogVariantDeleteJobCreateQuery: CatalogVariantDeleteJobCreateQuery)
Method alias:
CatalogsApi.createCatalogVariantBulkDeleteJob(catalogVariantDeleteJobCreateQuery: CatalogVariantDeleteJobCreateQuery)

Bulk Update Catalog Categories

CatalogsApi.bulkUpdateCatalogCategories(catalogCategoryUpdateJobCreateQuery: CatalogCategoryUpdateJobCreateQuery)
Method alias:
CatalogsApi.spawnUpdateCategoriesJob(catalogCategoryUpdateJobCreateQuery: CatalogCategoryUpdateJobCreateQuery)
Method alias:
CatalogsApi.createCatalogCategoryBulkUpdateJob(catalogCategoryUpdateJobCreateQuery: CatalogCategoryUpdateJobCreateQuery)

Bulk Update Catalog Items

CatalogsApi.bulkUpdateCatalogItems(catalogItemUpdateJobCreateQuery: CatalogItemUpdateJobCreateQuery)
Method alias:
CatalogsApi.spawnUpdateItemsJob(catalogItemUpdateJobCreateQuery: CatalogItemUpdateJobCreateQuery)
Method alias:
CatalogsApi.createCatalogItemBulkUpdateJob(catalogItemUpdateJobCreateQuery: CatalogItemUpdateJobCreateQuery)

Bulk Update Catalog Variants

CatalogsApi.bulkUpdateCatalogVariants(catalogVariantUpdateJobCreateQuery: CatalogVariantUpdateJobCreateQuery)
Method alias:
CatalogsApi.spawnUpdateVariantsJob(catalogVariantUpdateJobCreateQuery: CatalogVariantUpdateJobCreateQuery)
Method alias:
CatalogsApi.createCatalogVariantBulkUpdateJob(catalogVariantUpdateJobCreateQuery: CatalogVariantUpdateJobCreateQuery)

Create Back In Stock Subscription

CatalogsApi.createBackInStockSubscription(serverBISSubscriptionCreateQuery: ServerBISSubscriptionCreateQuery)

Create Catalog Category

CatalogsApi.createCatalogCategory(catalogCategoryCreateQuery: CatalogCategoryCreateQuery)

Create Catalog Item

CatalogsApi.createCatalogItem(catalogItemCreateQuery: CatalogItemCreateQuery)

Create Catalog Variant

CatalogsApi.createCatalogVariant(catalogVariantCreateQuery: CatalogVariantCreateQuery)

Delete Catalog Category

CatalogsApi.deleteCatalogCategory(id: string)

Delete Catalog Item

CatalogsApi.deleteCatalogItem(id: string)

Delete Catalog Variant

CatalogsApi.deleteCatalogVariant(id: string)

Get Bulk Create Catalog Items Job

CatalogsApi.getBulkCreateCatalogItemsJob(jobId: string, options)
Method alias:
CatalogsApi.getCreateItemsJob(jobId: string, options)
Method alias:
CatalogsApi.getCatalogItemBulkCreateJob(jobId: string, options)

Get Bulk Create Catalog Items Jobs

CatalogsApi.getBulkCreateCatalogItemsJobs(options)
Method alias:
CatalogsApi.getCreateItemsJobs(options)
Method alias:
CatalogsApi.getCatalogItemBulkCreateJobs(options)

Get Bulk Delete Catalog Items Job

CatalogsApi.getBulkDeleteCatalogItemsJob(jobId: string, options)
Method alias:
CatalogsApi.getDeleteItemsJob(jobId: string, options)
Method alias:
CatalogsApi.getCatalogItemBulkDeleteJob(jobId: string, options)

Get Bulk Delete Catalog Items Jobs

CatalogsApi.getBulkDeleteCatalogItemsJobs(options)
Method alias:
CatalogsApi.getDeleteItemsJobs(options)
Method alias:
CatalogsApi.getCatalogItemBulkDeleteJobs(options)

Get Bulk Update Catalog Items Job

CatalogsApi.getBulkUpdateCatalogItemsJob(jobId: string, options)
Method alias:
CatalogsApi.getUpdateItemsJob(jobId: string, options)
Method alias:
CatalogsApi.getCatalogItemBulkUpdateJob(jobId: string, options)

Get Bulk Update Catalog Items Jobs

CatalogsApi.getBulkUpdateCatalogItemsJobs(options)
Method alias:
CatalogsApi.getUpdateItemsJobs(options)
Method alias:
CatalogsApi.getCatalogItemBulkUpdateJobs(options)

Get Catalog Categories

CatalogsApi.getCatalogCategories(options)

Get Catalog Category

CatalogsApi.getCatalogCategory(id: string, options)

Get Catalog Item

CatalogsApi.getCatalogItem(id: string, options)

Get Catalog Items

CatalogsApi.getCatalogItems(options)

Get Catalog Variant

CatalogsApi.getCatalogVariant(id: string, options)

Get Catalog Variants

CatalogsApi.getCatalogVariants(options)

Get Categories for Catalog Item

CatalogsApi.getCategoriesForCatalogItem(id: string, options)
Method alias:
CatalogsApi.getCatalogItemCategories(id: string, options)

Get Category IDs for Catalog Item

CatalogsApi.getCategoryIdsForCatalogItem(id: string, options)
Method alias:
CatalogsApi.getCatalogItemRelationshipsCategories(id: string, options)

Get Create Categories Job

CatalogsApi.getCreateCategoriesJob(jobId: string, options)
Method alias:
CatalogsApi.getCatalogCategoryBulkCreateJob(jobId: string, options)

Get Create Categories Jobs

CatalogsApi.getCreateCategoriesJobs(options)
Method alias:
CatalogsApi.getCatalogCategoryBulkCreateJobs(options)

Get Create Variants Job

CatalogsApi.getCreateVariantsJob(jobId: string, options)
Method alias:
CatalogsApi.getCatalogVariantBulkCreateJob(jobId: string, options)

Get Create Variants Jobs

CatalogsApi.getCreateVariantsJobs(options)
Method alias:
CatalogsApi.getCatalogVariantBulkCreateJobs(options)

Get Delete Categories Job

CatalogsApi.getDeleteCategoriesJob(jobId: string, options)
Method alias:
CatalogsApi.getCatalogCategoryBulkDeleteJob(jobId: string, options)

Get Delete Categories Jobs

CatalogsApi.getDeleteCategoriesJobs(options)
Method alias:
CatalogsApi.getCatalogCategoryBulkDeleteJobs(options)

Get Delete Variants Job

CatalogsApi.getDeleteVariantsJob(jobId: string, options)
Method alias:
CatalogsApi.getCatalogVariantBulkDeleteJob(jobId: string, options)

Get Delete Variants Jobs

CatalogsApi.getDeleteVariantsJobs(options)
Method alias:
CatalogsApi.getCatalogVariantBulkDeleteJobs(options)

Get Item IDs for Catalog Category

CatalogsApi.getItemIdsForCatalogCategory(id: string, options)
Method alias:
CatalogsApi.getCatalogCategoryRelationshipsItems(id: string, options)

Get Items for Catalog Category

CatalogsApi.getItemsForCatalogCategory(id: string, options)
Method alias:
CatalogsApi.getCatalogCategoryItems(id: string, options)

Get Update Categories Job

CatalogsApi.getUpdateCategoriesJob(jobId: string, options)
Method alias:
CatalogsApi.getCatalogCategoryBulkUpdateJob(jobId: string, options)

Get Update Categories Jobs

CatalogsApi.getUpdateCategoriesJobs(options)
Method alias:
CatalogsApi.getCatalogCategoryBulkUpdateJobs(options)

Get Update Variants Job

CatalogsApi.getUpdateVariantsJob(jobId: string, options)
Method alias:
CatalogsApi.getCatalogVariantBulkUpdateJob(jobId: string, options)

Get Update Variants Jobs

CatalogsApi.getUpdateVariantsJobs(options)
Method alias:
CatalogsApi.getCatalogVariantBulkUpdateJobs(options)

Get Variants for Catalog Item

CatalogsApi.getVariantsForCatalogItem(id: string, options)
Method alias:
CatalogsApi.getCatalogItemVariants(id: string, options)

Remove Categories from Catalog Item

CatalogsApi.removeCategoriesFromCatalogItem(id: string, catalogItemCategoryOp: CatalogItemCategoryOp)
Method alias:
CatalogsApi.deleteCatalogItemRelationshipsCategories(id: string, catalogItemCategoryOp: CatalogItemCategoryOp)

Remove Items from Catalog Category

CatalogsApi.removeItemsFromCatalogCategory(id: string, catalogCategoryItemOp: CatalogCategoryItemOp)
Method alias:
CatalogsApi.deleteCatalogCategoryRelationshipsItems(id: string, catalogCategoryItemOp: CatalogCategoryItemOp)

Update Catalog Category

CatalogsApi.updateCatalogCategory(id: string, catalogCategoryUpdateQuery: CatalogCategoryUpdateQuery)

Update Catalog Item

CatalogsApi.updateCatalogItem(id: string, catalogItemUpdateQuery: CatalogItemUpdateQuery)

Update Catalog Variant

CatalogsApi.updateCatalogVariant(id: string, catalogVariantUpdateQuery: CatalogVariantUpdateQuery)

Update Categories for Catalog Item

CatalogsApi.updateCategoriesForCatalogItem(id: string, catalogItemCategoryOp: CatalogItemCategoryOp)
Method alias:
CatalogsApi.updateCatalogItemRelationshipsCategories(id: string, catalogItemCategoryOp: CatalogItemCategoryOp)

Update Items for Catalog Category

CatalogsApi.updateItemsForCatalogCategory(id: string, catalogCategoryItemOp: CatalogCategoryItemOp)
Method alias:
CatalogsApi.updateCatalogCategoryRelationshipsItems(id: string, catalogCategoryItemOp: CatalogCategoryItemOp)

CouponsApi


Bulk Create Coupon Codes

CouponsApi.bulkCreateCouponCodes(couponCodeCreateJobCreateQuery: CouponCodeCreateJobCreateQuery)
Method alias:
CouponsApi.spawnCouponCodeBulkCreateJob(couponCodeCreateJobCreateQuery: CouponCodeCreateJobCreateQuery)
Method alias:
CouponsApi.createCouponCodeBulkCreateJob(couponCodeCreateJobCreateQuery: CouponCodeCreateJobCreateQuery)

Create Coupon

CouponsApi.createCoupon(couponCreateQuery: CouponCreateQuery)

Create Coupon Code

CouponsApi.createCouponCode(couponCodeCreateQuery: CouponCodeCreateQuery)

Delete Coupon

CouponsApi.deleteCoupon(id: string)

Delete Coupon Code

CouponsApi.deleteCouponCode(id: string)

Get Bulk Create Coupon Code Jobs

CouponsApi.getBulkCreateCouponCodeJobs(options)
Method alias:
CouponsApi.getCouponCodeBulkCreateJobs(options)

Get Bulk Create Coupon Codes Job

CouponsApi.getBulkCreateCouponCodesJob(jobId: string, options)
Method alias:
CouponsApi.getCouponCodeBulkCreateJob(jobId: string, options)

Get Coupon

CouponsApi.getCoupon(id: string, options)

Get Coupon Code

CouponsApi.getCouponCode(id: string, options)

Get Coupon Code IDs for Coupon

CouponsApi.getCouponCodeIdsForCoupon(id: string, options)
Method alias:
CouponsApi.getCouponCodeRelationshipsCoupon(id: string, options)
Method alias:
CouponsApi.getCodeIdsForCoupon(id: string, options)
Method alias:
CouponsApi.getCouponRelationshipsCodes(id: string, options)

Get Coupon Codes

CouponsApi.getCouponCodes(options)

Get Coupon Codes for Coupon

CouponsApi.getCouponCodesForCoupon(id: string, options)
Method alias:
CouponsApi.getCouponCouponCodes(id: string, options)
Method alias:
CouponsApi.getCodesForCoupon(id: string, options)

Get Coupon For Coupon Code

CouponsApi.getCouponForCouponCode(id: string, options)
Method alias:
CouponsApi.getCouponCodeCoupon(id: string, options)

Get Coupon ID for Coupon Code

CouponsApi.getCouponIdForCouponCode(id: string)
Method alias:
CouponsApi.getCouponRelationshipsCouponCodes(id: string)

Get Coupons

CouponsApi.getCoupons(options)

Update Coupon

CouponsApi.updateCoupon(id: string, couponUpdateQuery: CouponUpdateQuery)

Update Coupon Code

CouponsApi.updateCouponCode(id: string, couponCodeUpdateQuery: CouponCodeUpdateQuery)

DataPrivacyApi


Request Profile Deletion

DataPrivacyApi.requestProfileDeletion(dataPrivacyCreateDeletionJobQuery: DataPrivacyCreateDeletionJobQuery)
Method alias:
DataPrivacyApi.createDataPrivacyDeletionJob(dataPrivacyCreateDeletionJobQuery: DataPrivacyCreateDeletionJobQuery)

EventsApi


Bulk Create Events

EventsApi.bulkCreateEvents(eventsBulkCreateJob: EventsBulkCreateJob)
Method alias:
EventsApi.createEventBulkCreateJob(eventsBulkCreateJob: EventsBulkCreateJob)

Create Event

EventsApi.createEvent(eventCreateQueryV2: EventCreateQueryV2)

Get Event

EventsApi.getEvent(id: string, options)

Get Events

EventsApi.getEvents(options)

Get Metric for Event

EventsApi.getMetricForEvent(id: string, options)
Method alias:
EventsApi.getEventMetric(id: string, options)

Get Metric ID for Event

EventsApi.getMetricIdForEvent(id: string)
Method alias:
EventsApi.getEventRelationshipsMetric(id: string)

Get Profile for Event

EventsApi.getProfileForEvent(id: string, options)
Method alias:
EventsApi.getEventProfile(id: string, options)

Get Profile ID for Event

EventsApi.getProfileIdForEvent(id: string)
Method alias:
EventsApi.getEventRelationshipsProfile(id: string)

FlowsApi


Delete Flow

FlowsApi.deleteFlow(id: string)

Get Action for Flow Message

FlowsApi.getActionForFlowMessage(id: string, options)
Method alias:
FlowsApi.getFlowMessageAction(id: string, options)

Get Action ID for Flow Message

FlowsApi.getActionIdForFlowMessage(id: string)
Method alias:
FlowsApi.getFlowMessageRelationshipsAction(id: string)

Get Action IDs for Flow

FlowsApi.getActionIdsForFlow(id: string, options)
Method alias:
FlowsApi.getFlowRelationshipsFlowActions(id: string, options)
Method alias:
FlowsApi.getFlowRelationshipsActions(id: string, options)

Get Actions for Flow

FlowsApi.getActionsForFlow(id: string, options)
Method alias:
FlowsApi.getFlowFlowActions(id: string, options)
Method alias:
FlowsApi.getFlowActions(id: string, options)

Get Flow

FlowsApi.getFlow(id: string, options)

Get Flow Action

FlowsApi.getFlowAction(id: string, options)

Get Flow for Flow Action

FlowsApi.getFlowForFlowAction(id: string, options)
Method alias:
FlowsApi.getFlowActionFlow(id: string, options)

Get Flow ID for Flow Action

FlowsApi.getFlowIdForFlowAction(id: string)
Method alias:
FlowsApi.getFlowActionRelationshipsFlow(id: string)

Get Flow Message

FlowsApi.getFlowMessage(id: string, options)

Get Flows

FlowsApi.getFlows(options)

Get Message IDs for Flow Action

FlowsApi.getMessageIdsForFlowAction(id: string, options)
Method alias:
FlowsApi.getFlowActionRelationshipsMessages(id: string, options)

Get Messages for Flow Action

FlowsApi.getMessagesForFlowAction(id: string, options)
Method alias:
FlowsApi.getFlowActionMessages(id: string, options)

Get Tag IDs for Flow

FlowsApi.getTagIdsForFlow(id: string)
Method alias:
FlowsApi.getFlowRelationshipsTags(id: string)

Get Tags for Flow

FlowsApi.getTagsForFlow(id: string, options)
Method alias:
FlowsApi.getFlowTags(id: string, options)

Get Template for Flow Message

FlowsApi.getTemplateForFlowMessage(id: string, options)
Method alias:
FlowsApi.getFlowMessageTemplate(id: string, options)

Get Template ID for Flow Message

FlowsApi.getTemplateIdForFlowMessage(id: string)
Method alias:
FlowsApi.getFlowMessageRelationshipsTemplate(id: string)

Update Flow Status

FlowsApi.updateFlow(id: string, flowUpdateQuery: FlowUpdateQuery)

FormsApi


Get Form

FormsApi.getForm(id: string, options)

Get Form for Form Version

FormsApi.getFormForFormVersion(id: string, options)
Method alias:
FormsApi.getFormVersionForm(id: string, options)

Get Form ID for Form Version

FormsApi.getFormIdForFormVersion(id: string)
Method alias:
FormsApi.getFormVersionRelationshipsForm(id: string)

Get Form Version

FormsApi.getFormVersion(id: string,