HomeGuidesAPI Reference
ChangelogHelp CenterCommunityContact Us
Guides

Audit your Klaviyo API usage

Learn how to audit your API endpoint usage, so you can migrate to Klaviyo’s newest APIs.

🚧

v1/v2 legacy APIs are scheduled to retire on June 30, 2024.

Users of Klaviyo's v1/v2 APIs have until June 30, 2024 to migrate to our new APIs. At this time, our v1/v2 APIs will officially be retired. To learn more about Klaviyo’s API lifecycle, check out our updated API versioning and deprecation policy.

Before you begin

Check out our video below on how to use Klaviyo's API audit tool:

It is important to migrate to our date-versioned APIs (revisions) before retired connections cause data failures in your account. It's best practice to connect your apps to the latest stable revision of our APIs every 12-18 months. Migration to our date-versioned APIs begins with auditing your endpoint usage to manage calls to our v1/v2 APIs.

To this end, you can download an API report, which is a CSV containing all API calls coming from your account.

You can also:

  • Review private API keys and labels.
  • Utilize Klaviyo’s API usage tools, such as the API activity dashboard.
  • Check custom metrics and profile properties.

📘

No migration needed for klaviyo object usage

You may be currently using our klaviyo object to capture certain metrics such as Active on Site, Viewed Product, Added to Cart, Started Checkout, or more. Note that API calls via klaviyo object will not need to be migrated. These calls are being migrated under the hood and will continue to be supported in the future.

Use the API report

Download the report

API report data refreshes once every 24 hours and looks back 14 days.

From the Developer tools dashboard, locate the Audit API Endpoints section.

Click Export API Report to begin exporting your API usage data. Depending on the quantity of API usage data in your account, the download may take several minutes. When the export completes, the CSV file will have the following name format: account id end-of-api-info-timeframe.csv

Included fields

The following fields are included in the report. You can use the Endpoint Path field to see which calls were made from our legacy endpoints. Please note that all paths beginning with /v1, /v2. /track, or /identify are legacy endpoint calls.

Field nameDescription
HTTP MethodThe HTTP method of the call (e.g., GET, POST, PATCH)
Endpoint PathURL of the legacy endpoint
API RevisionRevision used in the API request
Account ID / Public API KeyAccount ID (as known as a public API key) used to make the request
Private API KeyPrivate API key used to make the request
Key LabelAny labels attached to the request
Key Created DateDate the request was created
Key ScopesScopes that the private API key can call to make the request
Key Access LevelLevel of permissions used by your scopes (e.g., read, write, full)
Most Recent Request TimestampTimestamp of the most recent request in UNIX (UTC)
Number of RequestsQuantity of API requests made
Is Valid Revision FormatWhether or not the revision format is valid
Is PreRelease Revision (Alpha or Beta)Whether or not the revision is a prerelease (Alpha or Beta)
Legacy Endpoint DocsLink to the URL of the legacy endpoint used
New Docs (or Equivalent, for Legacy)Link to the URL of the equivalent new endpoint that should be used
NamespaceRelevant namespace for the endpoint used in the request
Is Client-Side APIWhether or not the call is to a client-side API
Report Time Range StartStarting date range of the audit report
Report Time Range EndEnding date range of the audit report
Report Download TimestampTime and date when the report was downloaded
User AgentOnly available for Track & Identify calls
Is v1/v2 Legacy EndpointBoolean value if the endpoint used is a legacy endpoint

Review private API keys and labels

Reviewing your account’s private API keys page can provide insight into where your API calls are being made. Work backwards with private API keys and labels to check your codebases for active v1/v2 API usage.

Utilize Klaviyo’s API usage tools

To view endpoints currently being used to access your account(s), use our tools for monitoring API usage. You can monitor recent activity with the API activity dashboard and view recent API requests in the API call log.

Check custom metrics and profile properties

Within the Metrics tab, you can filter by API using the dropdown. In the Profiles tab, you can check for custom profile properties. Audit how this data enters your system to determine whether or not you use legacy v1/v2 endpoints.

Metrics tab with the filter set to show only API generated metric

You may have additional metric types depending on how you have set up your custom integration. Be sure to audit your accounts so you know what metrics are coming from our klaviyo object vs direct API calls. Calls made directly from our APIs will need to be migrated.

Migrate from v1/v2 to our new APIs

Once you have audited your API endpoint usage, you can migrate to our new APIs. Check out a full list of our top migration resources.

Additional resources