@zernio/node 0.2.129 → 0.2.131

package/README.md

@@ -371,29 +371,21 @@ try {
 | `ads.listAdsBusinessCenters()` | List TikTok Business Centers |
 | `ads.listConversionAssociations()` | List campaigns associated with a conversion destination |
 | `ads.listConversionDestinations()` | List destinations for the Conversions API |
-| `ads.listTrackingTags()` | List tracking tags (Meta Pixels) |
-| `ads.listTrackingTagSharedAccounts()` | List ad accounts a tracking tag is shared with |
 | `ads.createConversionDestination()` | Create a conversion destination (LinkedIn) |
 | `ads.createCtwaAd()` | Create Click-to-WhatsApp ad |
 | `ads.createStandaloneAd()` | Create standalone ad |
-| `ads.createTrackingTag()` | Create a tracking tag (Meta Pixel) |
 | `ads.getAd()` | Get ad details |
 | `ads.getAdAnalytics()` | Get ad analytics |
 | `ads.getAdComments()` | List comments on an ad |
 | `ads.getConversionDestination()` | Fetch a single conversion destination |
 | `ads.getConversionMetrics()` | Fetch attribution metrics for a conversion destination |
-| `ads.getTrackingTag()` | Fetch a single tracking tag (Meta Pixel) |
-| `ads.getTrackingTagStats()` | Aggregated event stats for a tracking tag (Meta Pixel) |
 | `ads.updateAd()` | Update ad |
 | `ads.updateConversionDestination()` | Update a conversion destination |
-| `ads.updateTrackingTag()` | Update a tracking tag (Meta Pixel) |
 | `ads.deleteAd()` | Cancel an ad |
 | `ads.deleteConversionDestination()` | Soft-delete a conversion destination |
 | `ads.addConversionAssociations()` | Associate campaigns with a conversion destination |
-| `ads.addTrackingTagSharedAccount()` | Share a tracking tag with an ad account |
 | `ads.boostPost()` | Boost post as ad |
 | `ads.removeConversionAssociations()` | Remove campaign↔conversion associations |
-| `ads.removeTrackingTagSharedAccount()` | Stop sharing a tracking tag with an ad account |
 | `ads.searchAdInterests()` | Search targeting interests |
 | `ads.searchAdTargetingLocations()` | Search geo targeting locations (Meta) |
 | `ads.sendConversions()` | Send conversion events to an ad platform |
@@ -539,6 +531,18 @@ try {
 | `sequences.pauseSequence()` | Pause sequence |
 | `sequences.unenrollContact()` | Unenroll contact |
 
+### Tracking Tags
+| Method | Description |
+|--------|-------------|
+| `trackingTags.listTrackingTags()` | List tracking tags (Meta Pixels) |
+| `trackingTags.listTrackingTagSharedAccounts()` | List ad accounts a tracking tag is shared with |
+| `trackingTags.createTrackingTag()` | Create a tracking tag (Meta Pixel) |
+| `trackingTags.getTrackingTag()` | Fetch a single tracking tag (Meta Pixel) |
+| `trackingTags.getTrackingTagStats()` | Aggregated event stats for a tracking tag (Meta Pixel) |
+| `trackingTags.updateTrackingTag()` | Update a tracking tag (Meta Pixel) |
+| `trackingTags.addTrackingTagSharedAccount()` | Share a tracking tag with an ad account |
+| `trackingTags.removeTrackingTagSharedAccount()` | Stop sharing a tracking tag with an ad account |
+
 ### Twitter Engagement
 | Method | Description |
 |--------|-------------|

package/dist/index.d.mts

@@ -519,14 +519,6 @@ declare class Zernio {
         removeConversionAssociations: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<RemoveConversionAssociationsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<RemoveConversionAssociationsResponse, unknown, ThrowOnError>;
         getConversionMetrics: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetConversionMetricsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetConversionMetricsResponse, unknown, ThrowOnError>;
         createCtwaAd: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<CreateCtwaAdData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<CreateCtwaAdResponse, unknown, ThrowOnError>;
-        listTrackingTags: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<ListTrackingTagsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<ListTrackingTagsResponse, unknown, ThrowOnError>;
-        createTrackingTag: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<CreateTrackingTagData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<CreateTrackingTagResponse, unknown, ThrowOnError>;
-        getTrackingTag: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetTrackingTagData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetTrackingTagResponse, unknown, ThrowOnError>;
-        updateTrackingTag: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<UpdateTrackingTagData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<UpdateTrackingTagResponse, unknown, ThrowOnError>;
-        listTrackingTagSharedAccounts: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<ListTrackingTagSharedAccountsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<ListTrackingTagSharedAccountsResponse, unknown, ThrowOnError>;
-        addTrackingTagSharedAccount: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<AddTrackingTagSharedAccountData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<AddTrackingTagSharedAccountResponse, unknown, ThrowOnError>;
-        removeTrackingTagSharedAccount: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<RemoveTrackingTagSharedAccountData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<void, unknown, ThrowOnError>;
-        getTrackingTagStats: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetTrackingTagStatsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetTrackingTagStatsResponse, unknown, ThrowOnError>;
     };
     /**
      * adcampaigns API
@@ -552,6 +544,19 @@ declare class Zernio {
         deleteAdAudience: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<DeleteAdAudienceData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<DeleteAdAudienceResponse, unknown, ThrowOnError>;
         addUsersToAdAudience: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<AddUsersToAdAudienceData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<AddUsersToAdAudienceResponse, unknown, ThrowOnError>;
     };
+    /**
+     * trackingtags API
+     */
+    trackingtags: {
+        listTrackingTags: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<ListTrackingTagsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<ListTrackingTagsResponse, unknown, ThrowOnError>;
+        createTrackingTag: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<CreateTrackingTagData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<CreateTrackingTagResponse, unknown, ThrowOnError>;
+        getTrackingTag: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetTrackingTagData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetTrackingTagResponse, unknown, ThrowOnError>;
+        updateTrackingTag: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<UpdateTrackingTagData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<UpdateTrackingTagResponse, unknown, ThrowOnError>;
+        listTrackingTagSharedAccounts: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<ListTrackingTagSharedAccountsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<ListTrackingTagSharedAccountsResponse, unknown, ThrowOnError>;
+        addTrackingTagSharedAccount: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<AddTrackingTagSharedAccountData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<AddTrackingTagSharedAccountResponse, unknown, ThrowOnError>;
+        removeTrackingTagSharedAccount: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<RemoveTrackingTagSharedAccountData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<void, unknown, ThrowOnError>;
+        getTrackingTagStats: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetTrackingTagStatsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetTrackingTagStatsResponse, unknown, ThrowOnError>;
+    };
     /**
      * Create a new Zernio API client.
      *
@@ -13786,6 +13791,18 @@ type GetAdCommentsResponse = ({
          * Underlying post ID the comments belong to. effective_object_story_id for Facebook, effective_instagram_media_id for Instagram.
          */
         effectiveStoryId: string;
+        /**
+         * Instagram-only. The Instagram-scoped business ID that owns the boosted media (creative.instagram_user_id).
+         */
+        instagramUserId?: string;
+        /**
+         * Instagram-only. Public permalink of the boosted IG post (creative.instagram_permalink_url).
+         */
+        instagramPermalink?: string;
+        /**
+         * Instagram-only. The connected Instagram SocialAccount these comments were read through — use it for reply/hide actions via /v1/inbox/comments.
+         */
+        instagramAccountId?: string;
         /**
          * Social account ID (ads SocialAccount).
          */

package/dist/index.d.ts

@@ -519,14 +519,6 @@ declare class Zernio {
         removeConversionAssociations: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<RemoveConversionAssociationsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<RemoveConversionAssociationsResponse, unknown, ThrowOnError>;
         getConversionMetrics: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetConversionMetricsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetConversionMetricsResponse, unknown, ThrowOnError>;
         createCtwaAd: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<CreateCtwaAdData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<CreateCtwaAdResponse, unknown, ThrowOnError>;
-        listTrackingTags: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<ListTrackingTagsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<ListTrackingTagsResponse, unknown, ThrowOnError>;
-        createTrackingTag: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<CreateTrackingTagData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<CreateTrackingTagResponse, unknown, ThrowOnError>;
-        getTrackingTag: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetTrackingTagData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetTrackingTagResponse, unknown, ThrowOnError>;
-        updateTrackingTag: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<UpdateTrackingTagData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<UpdateTrackingTagResponse, unknown, ThrowOnError>;
-        listTrackingTagSharedAccounts: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<ListTrackingTagSharedAccountsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<ListTrackingTagSharedAccountsResponse, unknown, ThrowOnError>;
-        addTrackingTagSharedAccount: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<AddTrackingTagSharedAccountData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<AddTrackingTagSharedAccountResponse, unknown, ThrowOnError>;
-        removeTrackingTagSharedAccount: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<RemoveTrackingTagSharedAccountData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<void, unknown, ThrowOnError>;
-        getTrackingTagStats: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetTrackingTagStatsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetTrackingTagStatsResponse, unknown, ThrowOnError>;
     };
     /**
      * adcampaigns API
@@ -552,6 +544,19 @@ declare class Zernio {
         deleteAdAudience: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<DeleteAdAudienceData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<DeleteAdAudienceResponse, unknown, ThrowOnError>;
         addUsersToAdAudience: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<AddUsersToAdAudienceData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<AddUsersToAdAudienceResponse, unknown, ThrowOnError>;
     };
+    /**
+     * trackingtags API
+     */
+    trackingtags: {
+        listTrackingTags: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<ListTrackingTagsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<ListTrackingTagsResponse, unknown, ThrowOnError>;
+        createTrackingTag: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<CreateTrackingTagData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<CreateTrackingTagResponse, unknown, ThrowOnError>;
+        getTrackingTag: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetTrackingTagData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetTrackingTagResponse, unknown, ThrowOnError>;
+        updateTrackingTag: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<UpdateTrackingTagData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<UpdateTrackingTagResponse, unknown, ThrowOnError>;
+        listTrackingTagSharedAccounts: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<ListTrackingTagSharedAccountsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<ListTrackingTagSharedAccountsResponse, unknown, ThrowOnError>;
+        addTrackingTagSharedAccount: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<AddTrackingTagSharedAccountData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<AddTrackingTagSharedAccountResponse, unknown, ThrowOnError>;
+        removeTrackingTagSharedAccount: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<RemoveTrackingTagSharedAccountData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<void, unknown, ThrowOnError>;
+        getTrackingTagStats: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetTrackingTagStatsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetTrackingTagStatsResponse, unknown, ThrowOnError>;
+    };
     /**
      * Create a new Zernio API client.
      *
@@ -13786,6 +13791,18 @@ type GetAdCommentsResponse = ({
          * Underlying post ID the comments belong to. effective_object_story_id for Facebook, effective_instagram_media_id for Instagram.
          */
         effectiveStoryId: string;
+        /**
+         * Instagram-only. The Instagram-scoped business ID that owns the boosted media (creative.instagram_user_id).
+         */
+        instagramUserId?: string;
+        /**
+         * Instagram-only. Public permalink of the boosted IG post (creative.instagram_permalink_url).
+         */
+        instagramPermalink?: string;
+        /**
+         * Instagram-only. The connected Instagram SocialAccount these comments were read through — use it for reply/hide actions via /v1/inbox/comments.
+         */
+        instagramAccountId?: string;
         /**
          * Social account ID (ads SocialAccount).
          */

package/dist/index.js

@@ -2583,15 +2583,7 @@ var Zernio = class {
       addConversionAssociations,
       removeConversionAssociations,
       getConversionMetrics,
-      createCtwaAd,
-      listTrackingTags,
-      createTrackingTag,
-      getTrackingTag,
-      updateTrackingTag,
-      listTrackingTagSharedAccounts,
-      addTrackingTagSharedAccount,
-      removeTrackingTagSharedAccount,
-      getTrackingTagStats
+      createCtwaAd
     };
     /**
      * adcampaigns API
@@ -2617,6 +2609,19 @@ var Zernio = class {
       deleteAdAudience,
       addUsersToAdAudience
     };
+    /**
+     * trackingtags API
+     */
+    this.trackingtags = {
+      listTrackingTags,
+      createTrackingTag,
+      getTrackingTag,
+      updateTrackingTag,
+      listTrackingTagSharedAccounts,
+      addTrackingTagSharedAccount,
+      removeTrackingTagSharedAccount,
+      getTrackingTagStats
+    };
     const apiKey = options.apiKey ?? process.env["ZERNIO_API_KEY"] ?? process.env["LATE_API_KEY"];
     if (!apiKey) {
       throw new ZernioApiError(

package/dist/index.mjs

@@ -2552,15 +2552,7 @@ var Zernio = class {
       addConversionAssociations,
       removeConversionAssociations,
       getConversionMetrics,
-      createCtwaAd,
-      listTrackingTags,
-      createTrackingTag,
-      getTrackingTag,
-      updateTrackingTag,
-      listTrackingTagSharedAccounts,
-      addTrackingTagSharedAccount,
-      removeTrackingTagSharedAccount,
-      getTrackingTagStats
+      createCtwaAd
     };
     /**
      * adcampaigns API
@@ -2586,6 +2578,19 @@ var Zernio = class {
       deleteAdAudience,
       addUsersToAdAudience
     };
+    /**
+     * trackingtags API
+     */
+    this.trackingtags = {
+      listTrackingTags,
+      createTrackingTag,
+      getTrackingTag,
+      updateTrackingTag,
+      listTrackingTagSharedAccounts,
+      addTrackingTagSharedAccount,
+      removeTrackingTagSharedAccount,
+      getTrackingTagStats
+    };
     const apiKey = options.apiKey ?? process.env["ZERNIO_API_KEY"] ?? process.env["LATE_API_KEY"];
     if (!apiKey) {
       throw new ZernioApiError(

package/package.json

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

package/src/client.ts

@@ -852,14 +852,6 @@ export class Zernio {
     removeConversionAssociations: removeConversionAssociations,
     getConversionMetrics: getConversionMetrics,
     createCtwaAd: createCtwaAd,
-    listTrackingTags: listTrackingTags,
-    createTrackingTag: createTrackingTag,
-    getTrackingTag: getTrackingTag,
-    updateTrackingTag: updateTrackingTag,
-    listTrackingTagSharedAccounts: listTrackingTagSharedAccounts,
-    addTrackingTagSharedAccount: addTrackingTagSharedAccount,
-    removeTrackingTagSharedAccount: removeTrackingTagSharedAccount,
-    getTrackingTagStats: getTrackingTagStats,
   };
 
   /**
@@ -888,6 +880,20 @@ export class Zernio {
     addUsersToAdAudience: addUsersToAdAudience,
   };
 
+  /**
+   * trackingtags API
+   */
+  trackingtags = {
+    listTrackingTags: listTrackingTags,
+    createTrackingTag: createTrackingTag,
+    getTrackingTag: getTrackingTag,
+    updateTrackingTag: updateTrackingTag,
+    listTrackingTagSharedAccounts: listTrackingTagSharedAccounts,
+    addTrackingTagSharedAccount: addTrackingTagSharedAccount,
+    removeTrackingTagSharedAccount: removeTrackingTagSharedAccount,
+    getTrackingTagStats: getTrackingTagStats,
+  };
+
   /**
    * Create a new Zernio API client.
    *

package/src/generated/sdk.gen.ts

@@ -3474,6 +3474,11 @@ export const getAdAnalytics = <ThrowOnError extends boolean = false>(options: Op
  * effective_instagram_media_id (Instagram) via the Marketing API on each call
  * (cached in-process by the platform client), then fetches comments from the Graph API.
  *
+ * For Instagram-placed ads, the Instagram account that runs the ad must be connected
+ * to Zernio — comments are read through that account's token. If none of the connected
+ * Instagram accounts on the profile can read the ad's media, the call returns
+ * ads_connection_required.
+ *
  * Meta-only. Other ad platforms (TikTok, LinkedIn, Pinterest, Google, X) do not
  * expose a public per-ad comments API and return feature_not_available.
  *

package/src/generated/types.gen.ts

@@ -14111,6 +14111,18 @@ export type GetAdCommentsResponse = ({
          * Underlying post ID the comments belong to. effective_object_story_id for Facebook, effective_instagram_media_id for Instagram.
          */
         effectiveStoryId: string;
+        /**
+         * Instagram-only. The Instagram-scoped business ID that owns the boosted media (creative.instagram_user_id).
+         */
+        instagramUserId?: string;
+        /**
+         * Instagram-only. Public permalink of the boosted IG post (creative.instagram_permalink_url).
+         */
+        instagramPermalink?: string;
+        /**
+         * Instagram-only. The connected Instagram SocialAccount these comments were read through — use it for reply/hide actions via /v1/inbox/comments.
+         */
+        instagramAccountId?: string;
         /**
          * Social account ID (ads SocialAccount).
          */