@zernio/node 0.2.981 → 0.2.983

package/dist/index.d.mts

@@ -5110,6 +5110,10 @@ type ConversionEvent = {
              *
              */
             li_fat_id?: string;
+            /**
+             * Pinterest click ID (the `epik` URL param or `_epik` cookie). Sent to Pinterest as `click_id`, not hashed.
+             */
+            epik?: string;
         };
     };
     /**
@@ -11233,6 +11237,10 @@ type TrackingTag = {
      * Unix seconds the tag was created.
      */
     creationTime?: number;
+    /**
+     * Customer data the tag matches automatically, where the platform reports it (Pinterest automatic enhanced match).
+     */
+    automaticMatchingFields?: Array<('em' | 'ph' | 'fn' | 'ln' | 'ge' | 'db' | 'ct' | 'st' | 'zp' | 'country' | 'external_id')>;
     /**
      * Business Manager id that owns the tag, or `null` when the tag lives
      * on a personal (non-BM) ad account. Such tags can't be shared with
@@ -46422,11 +46430,11 @@ type ReplaceAdAudienceCompaniesError = (unknown | {
 type GetConversionsQualityData = {
     query: {
         /**
-         * SocialAccount _id (must be a metaads account).
+         * SocialAccount _id (a metaads or pinterestads account).
          */
         accountId: string;
         /**
-         * Meta pixel/dataset ID.
+         * Meta pixel/dataset ID, or the numeric Pinterest ad account id.
          */
         destinationId: string;
     };
@@ -46455,7 +46463,7 @@ type GetConversionsQualityError = (ErrorResponse | {
 type SendConversionsData = {
     body: {
         /**
-         * SocialAccount ID (metaads, googleads, linkedinads, tiktokads, or openaiads).
+         * SocialAccount ID (metaads, googleads, linkedinads, tiktokads, openaiads, or pinterestads).
          */
         accountId: string;
         /**
@@ -46463,13 +46471,13 @@ type SendConversionsData = {
          * ID. For Google, the conversion action resource name. For
          * LinkedIn, the conversion rule ID or full
          * `urn:lla:llaPartnerConversion:{id}` URN. For OpenAI Ads, the
-         * pixel wire id.
+         * pixel wire id. For Pinterest, the numeric ad account id.
          *
          */
         destinationId: string;
         events: Array<ConversionEvent>;
         /**
-         * Meta `test_event_code` passthrough. Ignored by Google, LinkedIn, and OpenAI Ads.
+         * Meta `test_event_code` passthrough. On Pinterest any value sends the batch with `test=true` (validated, not recorded). Ignored by Google, LinkedIn, and OpenAI Ads.
          */
         testCode?: string;
         /**
@@ -46489,7 +46497,7 @@ type SendConversionsData = {
     };
 };
 type SendConversionsResponse = ({
-    platform?: 'metaads' | 'googleads' | 'linkedinads' | 'tiktokads' | 'openaiads';
+    platform?: 'metaads' | 'googleads' | 'linkedinads' | 'tiktokads' | 'openaiads' | 'pinterestads';
     /**
      * Events accepted by the platform.
      */
@@ -46921,13 +46929,13 @@ type UpdateCampaignConversionGoalsError = (ErrorResponse | {
 type ListConversionDestinationsData = {
     path: {
         /**
-         * SocialAccount ID (metaads, googleads, linkedinads, tiktokads, or openaiads).
+         * SocialAccount ID (metaads, googleads, linkedinads, tiktokads, openaiads, or pinterestads).
          */
         accountId: string;
     };
 };
 type ListConversionDestinationsResponse = ({
-    platform?: 'metaads' | 'googleads' | 'linkedinads' | 'tiktokads' | 'openaiads';
+    platform?: 'metaads' | 'googleads' | 'linkedinads' | 'tiktokads' | 'openaiads' | 'pinterestads';
     destinations?: Array<{
         /**
          * Destination identifier. Meta: pixel ID. Google:
@@ -48509,6 +48517,10 @@ type CreateTrackingTagData = {
          * OpenAI Ads only (ignored by Meta). When set, also provisions a standard conversion event setting wired to the new pixel, so `goal: conversions` ad creates on `POST /v1/ads/create` have an event to reference immediately.
          */
         defaultEventType?: 'order_created' | 'lead_created' | 'items_added' | 'contents_viewed' | 'checkout_started' | 'registration_completed' | 'subscription_created' | 'trial_started' | 'appointment_scheduled' | 'page_viewed' | 'app_installed' | 'app_opened';
+        /**
+         * Pinterest only (400 elsewhere). Customer data the new tag matches automatically (automatic enhanced match): `em` email, `ph` phone, `fn`/`ln` name, `ge` gender, `db` date of birth, `ct`/`st`/`zp`/`country` location, `external_id`. Pinterest has one switch for the name and one for the location, so `fn` turns on `ln` too and any location code turns on all four.
+         */
+        automaticMatchingFields?: Array<('em' | 'ph' | 'fn' | 'ln' | 'ge' | 'db' | 'ct' | 'st' | 'zp' | 'country' | 'external_id')>;
     };
     path: {
         /**
@@ -48567,6 +48579,10 @@ type UpdateTrackingTagData = {
         automaticMatchingFields?: Array<('em' | 'ph' | 'fn' | 'ln' | 'ge' | 'db' | 'ct' | 'st' | 'zp' | 'country' | 'external_id')>;
         firstPartyCookieStatus?: 'empty' | 'first_party_cookie_disabled' | 'first_party_cookie_enabled';
         dataUseSetting?: 'advertising_and_analytics' | 'analytics_only' | 'empty';
+        /**
+         * First-party cookie on or off (TikTok, LinkedIn). Platform-neutral alternative to `firstPartyCookieStatus`.
+         */
+        enableFirstPartyCookies?: boolean;
         /**
          * Google Ads: turn gclid auto-tagging on or off for the ad account.
          */

package/dist/index.d.ts

@@ -5110,6 +5110,10 @@ type ConversionEvent = {
              *
              */
             li_fat_id?: string;
+            /**
+             * Pinterest click ID (the `epik` URL param or `_epik` cookie). Sent to Pinterest as `click_id`, not hashed.
+             */
+            epik?: string;
         };
     };
     /**
@@ -11233,6 +11237,10 @@ type TrackingTag = {
      * Unix seconds the tag was created.
      */
     creationTime?: number;
+    /**
+     * Customer data the tag matches automatically, where the platform reports it (Pinterest automatic enhanced match).
+     */
+    automaticMatchingFields?: Array<('em' | 'ph' | 'fn' | 'ln' | 'ge' | 'db' | 'ct' | 'st' | 'zp' | 'country' | 'external_id')>;
     /**
      * Business Manager id that owns the tag, or `null` when the tag lives
      * on a personal (non-BM) ad account. Such tags can't be shared with
@@ -46422,11 +46430,11 @@ type ReplaceAdAudienceCompaniesError = (unknown | {
 type GetConversionsQualityData = {
     query: {
         /**
-         * SocialAccount _id (must be a metaads account).
+         * SocialAccount _id (a metaads or pinterestads account).
          */
         accountId: string;
         /**
-         * Meta pixel/dataset ID.
+         * Meta pixel/dataset ID, or the numeric Pinterest ad account id.
          */
         destinationId: string;
     };
@@ -46455,7 +46463,7 @@ type GetConversionsQualityError = (ErrorResponse | {
 type SendConversionsData = {
     body: {
         /**
-         * SocialAccount ID (metaads, googleads, linkedinads, tiktokads, or openaiads).
+         * SocialAccount ID (metaads, googleads, linkedinads, tiktokads, openaiads, or pinterestads).
          */
         accountId: string;
         /**
@@ -46463,13 +46471,13 @@ type SendConversionsData = {
          * ID. For Google, the conversion action resource name. For
          * LinkedIn, the conversion rule ID or full
          * `urn:lla:llaPartnerConversion:{id}` URN. For OpenAI Ads, the
-         * pixel wire id.
+         * pixel wire id. For Pinterest, the numeric ad account id.
          *
          */
         destinationId: string;
         events: Array<ConversionEvent>;
         /**
-         * Meta `test_event_code` passthrough. Ignored by Google, LinkedIn, and OpenAI Ads.
+         * Meta `test_event_code` passthrough. On Pinterest any value sends the batch with `test=true` (validated, not recorded). Ignored by Google, LinkedIn, and OpenAI Ads.
          */
         testCode?: string;
         /**
@@ -46489,7 +46497,7 @@ type SendConversionsData = {
     };
 };
 type SendConversionsResponse = ({
-    platform?: 'metaads' | 'googleads' | 'linkedinads' | 'tiktokads' | 'openaiads';
+    platform?: 'metaads' | 'googleads' | 'linkedinads' | 'tiktokads' | 'openaiads' | 'pinterestads';
     /**
      * Events accepted by the platform.
      */
@@ -46921,13 +46929,13 @@ type UpdateCampaignConversionGoalsError = (ErrorResponse | {
 type ListConversionDestinationsData = {
     path: {
         /**
-         * SocialAccount ID (metaads, googleads, linkedinads, tiktokads, or openaiads).
+         * SocialAccount ID (metaads, googleads, linkedinads, tiktokads, openaiads, or pinterestads).
          */
         accountId: string;
     };
 };
 type ListConversionDestinationsResponse = ({
-    platform?: 'metaads' | 'googleads' | 'linkedinads' | 'tiktokads' | 'openaiads';
+    platform?: 'metaads' | 'googleads' | 'linkedinads' | 'tiktokads' | 'openaiads' | 'pinterestads';
     destinations?: Array<{
         /**
          * Destination identifier. Meta: pixel ID. Google:
@@ -48509,6 +48517,10 @@ type CreateTrackingTagData = {
          * OpenAI Ads only (ignored by Meta). When set, also provisions a standard conversion event setting wired to the new pixel, so `goal: conversions` ad creates on `POST /v1/ads/create` have an event to reference immediately.
          */
         defaultEventType?: 'order_created' | 'lead_created' | 'items_added' | 'contents_viewed' | 'checkout_started' | 'registration_completed' | 'subscription_created' | 'trial_started' | 'appointment_scheduled' | 'page_viewed' | 'app_installed' | 'app_opened';
+        /**
+         * Pinterest only (400 elsewhere). Customer data the new tag matches automatically (automatic enhanced match): `em` email, `ph` phone, `fn`/`ln` name, `ge` gender, `db` date of birth, `ct`/`st`/`zp`/`country` location, `external_id`. Pinterest has one switch for the name and one for the location, so `fn` turns on `ln` too and any location code turns on all four.
+         */
+        automaticMatchingFields?: Array<('em' | 'ph' | 'fn' | 'ln' | 'ge' | 'db' | 'ct' | 'st' | 'zp' | 'country' | 'external_id')>;
     };
     path: {
         /**
@@ -48567,6 +48579,10 @@ type UpdateTrackingTagData = {
         automaticMatchingFields?: Array<('em' | 'ph' | 'fn' | 'ln' | 'ge' | 'db' | 'ct' | 'st' | 'zp' | 'country' | 'external_id')>;
         firstPartyCookieStatus?: 'empty' | 'first_party_cookie_disabled' | 'first_party_cookie_enabled';
         dataUseSetting?: 'advertising_and_analytics' | 'analytics_only' | 'empty';
+        /**
+         * First-party cookie on or off (TikTok, LinkedIn). Platform-neutral alternative to `firstPartyCookieStatus`.
+         */
+        enableFirstPartyCookies?: boolean;
         /**
          * Google Ads: turn gclid auto-tagging on or off for the ad account.
          */

package/dist/index.js

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@zernio/node",
-  version: "0.2.981",
+  version: "0.2.983",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",

package/dist/index.mjs

@@ -5,7 +5,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
 // package.json
 var package_default = {
   name: "@zernio/node",
-  version: "0.2.981",
+  version: "0.2.983",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zernio/node",
-  "version": "0.2.981",
+  "version": "0.2.983",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -12372,7 +12372,12 @@ export const replaceAdAudienceCompanies = <ThrowOnError extends boolean = false>
  * Get Event Match Quality
  * Reads Meta Event Match Quality (EMQ) and pixel↔CAPI event coverage for a
  * pixel/dataset, live from Meta's Dataset Quality API. Web events only (a
- * Meta limitation). Meta-only; other platforms return 405. Requires the Ads add-on.
+ * Meta limitation). Other platforms return 405, except Pinterest. Requires the Ads add-on.
+ *
+ * Pinterest (`pinterestads`): `destinationId` is the numeric ad account id. Rows come from
+ * Pinterest's Event Quality Score for Conversions API web events over the last 14 days,
+ * one per event name, with each identifier's coverage in `matchKeys` and
+ * `eventCoveragePercentage` set to the tag/API `event_id` overlap. No `compositeScore`.
  *
  */
 export const getConversionsQuality = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetConversionsQualityData, ThrowOnError>) => {
@@ -12394,6 +12399,7 @@ export const getConversionsQuality = <ThrowOnError extends boolean = false>(opti
  * - LinkedIn (`linkedinads`) via `/rest/conversionEvents`
  * - TikTok (`tiktokads`) via the Offline Events API `/offline/batch/` (OFFLINE conversions only)
  * - OpenAI Ads (`openaiads`) via its Conversions API (a separate host, `bzr.openai.com`)
+ * - Pinterest (`pinterestads`) via `POST /v5/ad_accounts/{id}/events`
  *
  * `destinationId` semantics differ per platform:
  *
@@ -12402,6 +12408,15 @@ export const getConversionsQuality = <ThrowOnError extends boolean = false>(opti
  * - LinkedIn: conversion rule ID or URN, e.g. `104012` or `urn:lla:llaPartnerConversion:104012`
  * - TikTok: Offline Event Set ID, e.g. `7057103914977558530`
  * - OpenAI Ads: pixel wire id (numeric `pixel_id`, distinct from the internal pixel id), as returned by `GET /v1/accounts/{accountId}/conversion-destinations`
+ * - Pinterest: numeric ad account id, e.g. `549755885175` (Pinterest attributes to the ad account, not to a tag)
+ *
+ * Pinterest notes: each event needs an `email`, or `ipAddress` plus `userAgent`; others are
+ * listed in `failures` with code `INVALID_EVENT` and the rest are still sent. `clickIds.epik`
+ * (the `_epik` cookie) is sent as `click_id`. `actionSource` `web` stays `web`, offline
+ * sources become `offline`, and app events need `platformData.action_source` `app_android`
+ * or `app_ios`. Pinterest answers per event, so one bad event does not fail its chunk
+ * (failures carry code `PINTEREST_EVENT_FAILED`). `consent.adUserData: DENIED` sets `opt_out`.
+ * The connected user needs a Business Access role on the ad account (403 otherwise).
  *
  * TikTok notes: this path sends OFFLINE conversions (in-store / CRM / call-center), not web-pixel
  * events. Each event must carry an email or phone (TikTok requires at least one). The connected
@@ -12436,6 +12451,7 @@ export const getConversionsQuality = <ThrowOnError extends boolean = false>(opti
  * - Google: ignored. The conversion action's category determines the event type. Send the standard name closest to your action for documentation, but the platform will not branch on it.
  * - LinkedIn: ignored. The conversion rule's `type` (LEAD, PURCHASE, etc.) is locked to the destination at rule-creation time. Send the standard name for documentation; LinkedIn does not branch on it.
  * - OpenAI Ads: a fixed subset of standard names (Purchase, Lead, AddToCart, ViewContent, InitiateCheckout, CompleteRegistration, Subscribe, StartTrial, Schedule) maps 1:1 onto OpenAI's own event-type enum; any other standard name or custom string is sent as `type: custom` with the name preserved.
+ * - Pinterest: standard names map onto Pinterest's (Purchase = `checkout`, AddToCart = `add_to_cart`, InitiateCheckout = `initiate_checkout`, AddPaymentInfo = `add_payment_info`, Lead = `lead`, CompleteRegistration = `signup`, Subscribe = `subscribe`, ViewContent = `view_content`, Search = `search`, PageView = `page_visit`); any other string is sent as is, so it matches an advertiser defined event of that name.
  *
  */
 export const sendConversions = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<SendConversionsData, ThrowOnError>) => {
@@ -12642,8 +12658,8 @@ export const updateCampaignConversionGoals = <ThrowOnError extends boolean = fal
 /**
  * List conversion destinations
  * Returns the list of pixels (Meta), conversion actions (Google),
- * conversion rules (LinkedIn), or pixels (OpenAI Ads) accessible to the
- * connected ads account. Use the returned `id` as `destinationId` when
+ * conversion rules (LinkedIn), pixels (OpenAI Ads) or ad accounts
+ * (Pinterest) accessible to the connected ads account. Use the returned `id` as `destinationId` when
  * posting to `POST /v1/ads/conversions`.
  *
  * For Google and LinkedIn, each destination's `type` reflects the
@@ -13629,6 +13645,11 @@ export const startBusinessAgentEvalRun = <ThrowOnError extends boolean = false>(
  * connection can read (an ad account the user has no Business Access role on is skipped).
  * `id` equals `siteTagId`, the id the site loads with `pintrk('load', id)`.
  *
+ * TikTok (platform `tiktokads`): TikTok Pixels across the connection's advertisers, or one
+ * advertiser with `?adAccountId=<numeric advertiser_id>`. `id` is the numeric `pixel_id`,
+ * `siteTagId` the alphanumeric `pixel_code` from Events Manager. Connections authorized
+ * before the Pixel Management permission (about 2026-05-28) answer 403 until reconnected.
+ *
  */
 export const listTrackingTags = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<ListTrackingTagsData, ThrowOnError>) => {
     return (options?.client ?? client).get<ListTrackingTagsResponse, ListTrackingTagsError, ThrowOnError>({
@@ -13675,8 +13696,9 @@ export const listTrackingTags = <ThrowOnError extends boolean = false>(options:
  *
  * Pinterest (platform `pinterestads`): creates a Pinterest tag on the numeric ad account
  * `adAccountId` (`POST /v5/ad_accounts/{id}/conversion_tags`). Returns the tag with
- * Pinterest's `code` snippet. NOT idempotent and Pinterest has no dry-run and no delete for
- * tags, so never retry blindly: list first.
+ * Pinterest's `code` snippet. `automaticMatchingFields` switches on automatic enhanced match
+ * for those fields. NOT idempotent and Pinterest has no dry-run and no delete for tags (DELETE
+ * on `conversion_tags/{id}` answers 405), so never retry blindly: list first.
  *
  * Google Ads (`googleads`): every Google Ads account has exactly one
  * Google tag (`AW-...`), so this is idempotent. `adAccountId` is the
@@ -13686,6 +13708,10 @@ export const listTrackingTags = <ThrowOnError extends boolean = false>(options:
  * created, which is what switches Google's conversion tracking on, and
  * the tag is returned with it as its first event.
  *
+ * TikTok: `POST /pixel/create/` on the advertiser in `adAccountId` (numeric). Names are at
+ * most 40 characters with no emoji and must be unique; TikTok refuses a duplicate name
+ * (400), which is its only retry guard. TikTok has no pixel delete API.
+ *
  */
 export const createTrackingTag = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<CreateTrackingTagData, ThrowOnError>) => {
     return (options?.client ?? client).post<CreateTrackingTagResponse, CreateTrackingTagError, ThrowOnError>({
@@ -13719,6 +13745,10 @@ export const createTrackingTag = <ThrowOnError extends boolean = false>(options:
  * and `lastFiredTime`. Without `adAccountId` Zernio finds the ad account that owns the tag
  * (404 when no readable ad account holds it).
  *
+ * TikTok: read from `/pixel/list/?pixel_id=`; `code` is TikTok's `pixel_script`, `events`
+ * the pixel events. `lastFiredTime` is not available on TikTok. Without `adAccountId` the
+ * connection's advertisers are searched.
+ *
  */
 export const getTrackingTag = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetTrackingTagData, ThrowOnError>) => {
     return (options?.client ?? client).get<GetTrackingTagResponse, GetTrackingTagError, ThrowOnError>({
@@ -13755,9 +13785,16 @@ export const getTrackingTag = <ThrowOnError extends boolean = false>(options: Op
  * `first_party_cookie_disabled`), which sets the tag's first-party tracking. It applies to
  * every ad account using the tag. `empty` answers 400: LinkedIn has no unset state.
  *
- * Pinterest (platform `pinterestads`): 501. Pinterest API v5 only creates, lists and reads
- * tags (no update endpoint); rename a tag or change its enhanced match settings in Pinterest
- * Ads Manager.
+ * Pinterest (platform `pinterestads`): 501. Pinterest API v5 has no endpoint to edit a tag:
+ * its spec lists only POST/GET on `conversion_tags` and GET on `conversion_tags/{id}`, and
+ * PATCH or PUT on `conversion_tags/{id}` answer 405 "Method not allowed". Set enhanced match
+ * at creation (`automaticMatchingFields`) or change it and the name in Pinterest Ads Manager.
+ *
+ * TikTok: `name`, `enableAutomaticMatching` + `automaticMatchingFields` (folded onto
+ * TikTok's five switches: em, ph, fn/ln, ct/st/zp/country, external_id; ge and db answer
+ * 400), and first-party cookies via `enableFirstPartyCookies` or `firstPartyCookieStatus`
+ * (enabled or disabled). TikTok has no pixel delete: the endpoint is absent from its API and
+ * `POST /pixel/delete/` answers 404.
  *
  */
 export const updateTrackingTag = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<UpdateTrackingTagData, ThrowOnError>) => {
@@ -13775,6 +13812,9 @@ export const updateTrackingTag = <ThrowOnError extends boolean = false>(options:
  * Insight Tag; the role (`FULL` or `USE_ONLY`) is appended to `name`. LinkedIn exposes
  * permissions per ad account only, so accounts the connection cannot see are not listed.
  *
+ * TikTok (`tiktokads`): the advertisers linked to the pixel in its Business Center
+ * (`/bc/pixel/link/get/`); a pixel outside Business Center answers 400.
+ *
  */
 export const listTrackingTagSharedAccounts = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<ListTrackingTagSharedAccountsData, ThrowOnError>) => {
     return (options?.client ?? client).get<ListTrackingTagSharedAccountsResponse, ListTrackingTagSharedAccountsError, ThrowOnError>({
@@ -13796,6 +13836,11 @@ export const listTrackingTagSharedAccounts = <ThrowOnError extends boolean = fal
  * `adAccountId` is the numeric LinkedIn ad account id. An ad account uses one Insight Tag at
  * a time, so a target that already has one answers 400.
  *
+ * TikTok: links the pixel to an advertiser through Business Center
+ * (`/bc/pixel/link/update/`, `adAccountId` = numeric advertiser_id). Only a pixel that is an
+ * asset of a Business Center this connection manages can be shared; otherwise the answer is
+ * 400 asking to transfer it to Business Center first.
+ *
  */
 export const addTrackingTagSharedAccount = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<AddTrackingTagSharedAccountData, ThrowOnError>) => {
     return (options?.client ?? client).post<AddTrackingTagSharedAccountResponse, AddTrackingTagSharedAccountError, ThrowOnError>({
@@ -13814,6 +13859,8 @@ export const addTrackingTagSharedAccount = <ThrowOnError extends boolean = false
  * revoking the last ad account that holds the tag: LinkedIn accepts that call and the tag
  * is orphaned (verified live).
  *
+ * TikTok: unlinks through Business Center (`/bc/pixel/link/update/` with `UNLINK`).
+ *
  */
 export const removeTrackingTagSharedAccount = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<RemoveTrackingTagSharedAccountData, ThrowOnError>) => {
     return (options?.client ?? client).delete<RemoveTrackingTagSharedAccountResponse, RemoveTrackingTagSharedAccountError, ThrowOnError>({
@@ -13943,8 +13990,8 @@ export const removeTrackingTagFromStore = <ThrowOnError extends boolean = false>
  * List conversion events
  * The tag's conversion events, on platforms where each conversion is its own object:
  * Google conversion actions, LinkedIn conversion rules, X web event tags, OpenAI event
- * settings, TikTok pixel events, Meta custom conversions. Platforms where events are just
- * names the site sends (Pinterest) answer 501.
+ * settings, TikTok pixel events, Meta custom conversions, Pinterest advertiser defined
+ * events.
  *
  * OpenAI Ads: the account's conversion event settings whose source is this pixel.
  * `siteEventId` is the event name the site sends (a standard event such as
@@ -13968,6 +14015,17 @@ export const removeTrackingTagFromStore = <ThrowOnError extends boolean = false>
  * Archived (removed) actions are listed with status `REMOVED`; imported (GA4, upload,
  * app) actions are not events of the tag.
  *
+ * Pinterest (platform `pinterestads`): the ad account's advertiser defined events, custom
+ * event names mapped to a standard type (`type`, e.g. `SIGNUP`). They belong to the ad
+ * account, so every tag on it shares them. `id`, `name` and `siteEventId` are all the event
+ * name, which the site sends as `pintrk('track', '<name>')` or the Conversions API sends as
+ * `event_name`. Standard events (`pagevisit`, `checkout`...) need no object and are not
+ * listed.
+ *
+ * TikTok: the pixel's events from `/pixel/list/`. TikTok refreshes this list every 2 to 4
+ * hours, so a just-created event can be missing. `siteEventId` is the `ttq.track()` name the
+ * site fires.
+ *
  */
 export const listTrackingTagEvents = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<ListTrackingTagEventsData, ThrowOnError>) => {
     return (options?.client ?? client).get<ListTrackingTagEventsResponse, ListTrackingTagEventsError, ThrowOnError>({
@@ -14025,6 +14083,21 @@ export const listTrackingTagEvents = <ThrowOnError extends boolean = false>(opti
  * are unique per account, so a replay answers 400 (DUPLICATE_NAME) instead of creating a
  * second one.
  *
+ * Pinterest (platform `pinterestads`): creates an advertiser defined event on the tag's ad
+ * account. Fields: `name` (1-100 letters, digits, `_` or `-`, case-insensitive, max 15 per
+ * ad account) and `type` (one of Pinterest's optimizable types: SIGNUP, ADD_TO_CART, LEAD,
+ * CHECKOUT, SUBSCRIBE, ADD_TO_WISHLIST, ADD_PAYMENT_INFO, INITIATE_CHECKOUT, CONTACT,
+ * CUSTOMIZE_PRODUCT, FIND_LOCATION, SCHEDULE, SUBMIT_APPLICATION, START_TRIAL, PAGE_VISIT,
+ * VIEW_CATEGORY, VIEW_CONTENT, SEARCH, WATCH_VIDEO) or `siteEvent`. A duplicate name answers
+ * 400.
+ *
+ * TikTok: `POST /pixel/event/create/`. `type` is a TikTok pixel event type (SHOPPING,
+ * ON_WEB_CART, ON_WEB_DETAIL, INITIATE_ORDER, ADD_BILLING, ON_WEB_SEARCH, PAGE_VIEW,
+ * ON_WEB_REGISTER, FORM, ...), or pass `siteEvent`. Stores `name` (at most 40 characters),
+ * `defaultValue` and `currency` (USD, JPY or INR only). TikTok returns no id: the new event
+ * is read back from the pixel, and while TikTok's listing has not refreshed the response
+ * carries an empty `id` and `status: pending`.
+ *
  */
 export const createTrackingTagEvent = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<CreateTrackingTagEventData, ThrowOnError>) => {
     return (options?.client ?? client).post<CreateTrackingTagEventResponse, CreateTrackingTagEventError, ThrowOnError>({
@@ -14052,6 +14125,13 @@ export const createTrackingTagEvent = <ThrowOnError extends boolean = false>(opt
  * answer 404). `enabled: false` archives the action (same as DELETE) and `enabled: true`
  * restores an archived one.
  *
+ * Pinterest (platform `pinterestads`): remaps the event to another `type` or `siteEvent`.
+ * Pinterest identifies the event by its name, so `name` cannot change (400): create the new
+ * name and delete the old one.
+ *
+ * TikTok: `name`, `defaultValue` and `currency` (USD, JPY or INR); the type cannot change
+ * (delete and recreate).
+ *
  */
 export const updateTrackingTagEvent = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<UpdateTrackingTagEventData, ThrowOnError>) => {
     return (options?.client ?? client).patch<UpdateTrackingTagEventResponse, UpdateTrackingTagEventError, ThrowOnError>({
@@ -14080,6 +14160,12 @@ export const updateTrackingTagEvent = <ThrowOnError extends boolean = false>(opt
  * it with status REMOVED and its history; PATCH with `enabled: true` restores it. Deleting
  * an already archived action succeeds without a call to Google.
  *
+ * Pinterest (platform `pinterestads`): stops Pinterest tracking the event name (`state:
+ * disabled`); Pinterest keeps the event's history.
+ *
+ * TikTok: hard delete (`/pixel/event/delete/`); TikTok refuses events bound to an ad group
+ * (400).
+ *
  */
 export const deleteTrackingTagEvent = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<DeleteTrackingTagEventData, ThrowOnError>) => {
     return (options?.client ?? client).delete<DeleteTrackingTagEventResponse, DeleteTrackingTagEventError, ThrowOnError>({
@@ -14200,6 +14286,11 @@ export const getTrackingTagDiagnostics = <ThrowOnError extends boolean = false>(
  * (ad-account level, not per tag; an account Pinterest cannot score yet carries `error`
  * instead). Pinterest has no time-bounded counts, so `startTime`/`endTime` answer 400.
  *
+ * TikTok: per-event counts from `/pixel/event/stats/` (`total_count`,
+ * `browser_event_total_count`, `server_event_total_count`, `attributed_count`,
+ * `preview_count`), bucketed by UTC day. Defaults to the last 7 days; at most 30 days per
+ * request. `aggregation` is not accepted.
+ *
  */
 export const getTrackingTagStats = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetTrackingTagStatsData, ThrowOnError>) => {
     return (options?.client ?? client).get<GetTrackingTagStatsResponse, GetTrackingTagStatsError, ThrowOnError>({

package/src/generated/types.gen.ts

@@ -3369,6 +3369,10 @@ export type ConversionEvent = {
              *
              */
             li_fat_id?: string;
+            /**
+             * Pinterest click ID (the `epik` URL param or `_epik` cookie). Sent to Pinterest as `click_id`, not hashed.
+             */
+            epik?: string;
         };
     };
     /**
@@ -9768,6 +9772,10 @@ export type TrackingTag = {
      * Unix seconds the tag was created.
      */
     creationTime?: number;
+    /**
+     * Customer data the tag matches automatically, where the platform reports it (Pinterest automatic enhanced match).
+     */
+    automaticMatchingFields?: Array<('em' | 'ph' | 'fn' | 'ln' | 'ge' | 'db' | 'ct' | 'st' | 'zp' | 'country' | 'external_id')>;
     /**
      * Business Manager id that owns the tag, or `null` when the tag lives
      * on a personal (non-BM) ad account. Such tags can't be shared with
@@ -47301,11 +47309,11 @@ export type ReplaceAdAudienceCompaniesError = (unknown | {
 export type GetConversionsQualityData = {
     query: {
         /**
-         * SocialAccount _id (must be a metaads account).
+         * SocialAccount _id (a metaads or pinterestads account).
          */
         accountId: string;
         /**
-         * Meta pixel/dataset ID.
+         * Meta pixel/dataset ID, or the numeric Pinterest ad account id.
          */
         destinationId: string;
     };
@@ -47337,7 +47345,7 @@ export type GetConversionsQualityError = (ErrorResponse | {
 export type SendConversionsData = {
     body: {
         /**
-         * SocialAccount ID (metaads, googleads, linkedinads, tiktokads, or openaiads).
+         * SocialAccount ID (metaads, googleads, linkedinads, tiktokads, openaiads, or pinterestads).
          */
         accountId: string;
         /**
@@ -47345,13 +47353,13 @@ export type SendConversionsData = {
          * ID. For Google, the conversion action resource name. For
          * LinkedIn, the conversion rule ID or full
          * `urn:lla:llaPartnerConversion:{id}` URN. For OpenAI Ads, the
-         * pixel wire id.
+         * pixel wire id. For Pinterest, the numeric ad account id.
          *
          */
         destinationId: string;
         events: Array<ConversionEvent>;
         /**
-         * Meta `test_event_code` passthrough. Ignored by Google, LinkedIn, and OpenAI Ads.
+         * Meta `test_event_code` passthrough. On Pinterest any value sends the batch with `test=true` (validated, not recorded). Ignored by Google, LinkedIn, and OpenAI Ads.
          */
         testCode?: string;
         /**
@@ -47372,7 +47380,7 @@ export type SendConversionsData = {
 };
 
 export type SendConversionsResponse = ({
-    platform?: 'metaads' | 'googleads' | 'linkedinads' | 'tiktokads' | 'openaiads';
+    platform?: 'metaads' | 'googleads' | 'linkedinads' | 'tiktokads' | 'openaiads' | 'pinterestads';
     /**
      * Events accepted by the platform.
      */
@@ -47842,14 +47850,14 @@ export type UpdateCampaignConversionGoalsError = (ErrorResponse | {
 export type ListConversionDestinationsData = {
     path: {
         /**
-         * SocialAccount ID (metaads, googleads, linkedinads, tiktokads, or openaiads).
+         * SocialAccount ID (metaads, googleads, linkedinads, tiktokads, openaiads, or pinterestads).
          */
         accountId: string;
     };
 };
 
 export type ListConversionDestinationsResponse = ({
-    platform?: 'metaads' | 'googleads' | 'linkedinads' | 'tiktokads' | 'openaiads';
+    platform?: 'metaads' | 'googleads' | 'linkedinads' | 'tiktokads' | 'openaiads' | 'pinterestads';
     destinations?: Array<{
         /**
          * Destination identifier. Meta: pixel ID. Google:
@@ -49646,6 +49654,10 @@ export type CreateTrackingTagData = {
          * OpenAI Ads only (ignored by Meta). When set, also provisions a standard conversion event setting wired to the new pixel, so `goal: conversions` ad creates on `POST /v1/ads/create` have an event to reference immediately.
          */
         defaultEventType?: 'order_created' | 'lead_created' | 'items_added' | 'contents_viewed' | 'checkout_started' | 'registration_completed' | 'subscription_created' | 'trial_started' | 'appointment_scheduled' | 'page_viewed' | 'app_installed' | 'app_opened';
+        /**
+         * Pinterest only (400 elsewhere). Customer data the new tag matches automatically (automatic enhanced match): `em` email, `ph` phone, `fn`/`ln` name, `ge` gender, `db` date of birth, `ct`/`st`/`zp`/`country` location, `external_id`. Pinterest has one switch for the name and one for the location, so `fn` turns on `ln` too and any location code turns on all four.
+         */
+        automaticMatchingFields?: Array<('em' | 'ph' | 'fn' | 'ln' | 'ge' | 'db' | 'ct' | 'st' | 'zp' | 'country' | 'external_id')>;
     };
     path: {
         /**
@@ -49710,6 +49722,10 @@ export type UpdateTrackingTagData = {
         automaticMatchingFields?: Array<('em' | 'ph' | 'fn' | 'ln' | 'ge' | 'db' | 'ct' | 'st' | 'zp' | 'country' | 'external_id')>;
         firstPartyCookieStatus?: 'empty' | 'first_party_cookie_disabled' | 'first_party_cookie_enabled';
         dataUseSetting?: 'advertising_and_analytics' | 'analytics_only' | 'empty';
+        /**
+         * First-party cookie on or off (TikTok, LinkedIn). Platform-neutral alternative to `firstPartyCookieStatus`.
+         */
+        enableFirstPartyCookies?: boolean;
         /**
          * Google Ads: turn gclid auto-tagging on or off for the ad account.
          */