@zernio/node 0.2.684 → 0.2.686

package/dist/index.d.mts

@@ -29575,11 +29575,11 @@ type ListAdCampaignsError = (ErrorResponse | {
 type CreateAdCampaignData = {
     body: {
         /**
-         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         * Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created.
          */
         accountId: string;
         /**
-         * Meta ad account id (act_<n>).
+         * Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...).
          */
         adAccountId: string;
         name: string;
@@ -30526,7 +30526,7 @@ type GenerateAdPreviewsData = {
          */
         accountId: string;
         /**
-         * Meta ad account id (act_<n>).
+         * Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...).
          */
         adAccountId: string;
         /**
@@ -31202,7 +31202,7 @@ type CreateRfPredictionData = {
          */
         accountId: string;
         /**
-         * Meta ad account id (act_<n>).
+         * Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...).
          */
         adAccountId: string;
         /**
@@ -31529,7 +31529,7 @@ type CreateAdCreativeData = {
          */
         accountId: string;
         /**
-         * Meta ad account id (act_<n>).
+         * Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...).
          */
         adAccountId: string;
         headline: string;
@@ -31619,7 +31619,7 @@ type GetAdCreativeError = (unknown | {
 type UpdateAdCreativeData = {
     body: {
         /**
-         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         * Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created.
          */
         accountId: string;
         name: string;
@@ -31696,11 +31696,11 @@ type ListValueRuleSetsError = (unknown | {
 type CreateValueRuleSetData = {
     body: {
         /**
-         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         * Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created.
          */
         accountId: string;
         /**
-         * Meta ad account id (act_<n>).
+         * Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...).
          */
         adAccountId: string;
         name: string;
@@ -31743,7 +31743,7 @@ type GetValueRuleSetError = (unknown | {
 type UpdateValueRuleSetData = {
     body: {
         /**
-         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         * Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created.
          */
         accountId: string;
         /**
@@ -33808,11 +33808,11 @@ type CreateTestLeadError = (ErrorResponse | {
 type UploadAdImageData = {
     body: {
         /**
-         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         * Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created.
          */
         accountId: string;
         /**
-         * Meta ad account id (act_<n>).
+         * Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...).
          */
         adAccountId: string;
         /**
@@ -33883,11 +33883,11 @@ type ListAdImagesError = (unknown | {
 type UploadAdVideoData = {
     body: {
         /**
-         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         * Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created.
          */
         accountId: string;
         /**
-         * Meta ad account id (act_<n>).
+         * Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...).
          */
         adAccountId: string;
         /**
@@ -35343,7 +35343,7 @@ type ListCustomConversionsError = (unknown | {
 type CreateCustomConversionData = {
     body: {
         /**
-         * Meta ad account id (act_<n>).
+         * Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...).
          */
         adAccountId: string;
         /**

package/dist/index.d.ts

@@ -29575,11 +29575,11 @@ type ListAdCampaignsError = (ErrorResponse | {
 type CreateAdCampaignData = {
     body: {
         /**
-         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         * Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created.
          */
         accountId: string;
         /**
-         * Meta ad account id (act_<n>).
+         * Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...).
          */
         adAccountId: string;
         name: string;
@@ -30526,7 +30526,7 @@ type GenerateAdPreviewsData = {
          */
         accountId: string;
         /**
-         * Meta ad account id (act_<n>).
+         * Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...).
          */
         adAccountId: string;
         /**
@@ -31202,7 +31202,7 @@ type CreateRfPredictionData = {
          */
         accountId: string;
         /**
-         * Meta ad account id (act_<n>).
+         * Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...).
          */
         adAccountId: string;
         /**
@@ -31529,7 +31529,7 @@ type CreateAdCreativeData = {
          */
         accountId: string;
         /**
-         * Meta ad account id (act_<n>).
+         * Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...).
          */
         adAccountId: string;
         headline: string;
@@ -31619,7 +31619,7 @@ type GetAdCreativeError = (unknown | {
 type UpdateAdCreativeData = {
     body: {
         /**
-         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         * Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created.
          */
         accountId: string;
         name: string;
@@ -31696,11 +31696,11 @@ type ListValueRuleSetsError = (unknown | {
 type CreateValueRuleSetData = {
     body: {
         /**
-         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         * Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created.
          */
         accountId: string;
         /**
-         * Meta ad account id (act_<n>).
+         * Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...).
          */
         adAccountId: string;
         name: string;
@@ -31743,7 +31743,7 @@ type GetValueRuleSetError = (unknown | {
 type UpdateValueRuleSetData = {
     body: {
         /**
-         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         * Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created.
          */
         accountId: string;
         /**
@@ -33808,11 +33808,11 @@ type CreateTestLeadError = (ErrorResponse | {
 type UploadAdImageData = {
     body: {
         /**
-         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         * Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created.
          */
         accountId: string;
         /**
-         * Meta ad account id (act_<n>).
+         * Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...).
          */
         adAccountId: string;
         /**
@@ -33883,11 +33883,11 @@ type ListAdImagesError = (unknown | {
 type UploadAdVideoData = {
     body: {
         /**
-         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         * Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created.
          */
         accountId: string;
         /**
-         * Meta ad account id (act_<n>).
+         * Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...).
          */
         adAccountId: string;
         /**
@@ -35343,7 +35343,7 @@ type ListCustomConversionsError = (unknown | {
 type CreateCustomConversionData = {
     body: {
         /**
-         * Meta ad account id (act_<n>).
+         * Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...).
          */
         adAccountId: string;
         /**

package/dist/index.js

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@zernio/node",
-  version: "0.2.684",
+  version: "0.2.686",
   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.684",
+  version: "0.2.686",
   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.684",
+  "version": "0.2.686",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -1986,9 +1986,9 @@ export const deleteGoogleBusinessReviewReply = <ThrowOnError extends boolean = f
  * Get pending OAuth data
  * Fetch pending OAuth data for headless mode using the pendingDataToken from the redirect URL.
  *
- * **Scope**: This endpoint is used for LinkedIn organizations, Snapchat profiles, and Pinterest boards, where the selection list is too large to fit in URL params. The redirect carries a `pendingDataToken` instead of the full payload; the response includes the corresponding selection array (e.g. `boards` for Pinterest). WhatsApp, Facebook, Google Business and other platforms pass selection state directly via URL query params on the redirect (`profileId`, `tempToken`, `step`), no pending record is created, so this endpoint will return 404 for those flows. Use the platform-specific selection endpoint instead (e.g. `/v1/connect/whatsapp/select-phone-number`).
+ * **Scope**: This endpoint is used for LinkedIn organizations, Google Business locations, Slack channels, Snapchat profiles, and Pinterest boards, where the selection list is too large to fit in URL params. The redirect carries a `pendingDataToken` instead of the full payload; the response includes the corresponding selection array (e.g. `boards` for Pinterest). WhatsApp, Facebook and other platforms pass selection state directly via URL query params on the redirect (`profileId`, `tempToken`, `step`), no pending record is created, so this endpoint will return 404 for those flows. Use the platform-specific selection endpoint instead (e.g. `/v1/connect/whatsapp/select-phone-number`).
  *
- * Token is one-time use and expires after 10 minutes. No authentication required.
+ * Reading the token does not consume it, so this fetch is repeatable until the token expires 1 hour after issuance. Completing the platform selection deletes the pending record, so the token stops working from then on. No authentication required.
  *
  */
 export const getPendingOAuthData = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetPendingOAuthDataData, ThrowOnError>) => {
@@ -7697,11 +7697,16 @@ export const listAdCampaigns = <ThrowOnError extends boolean = false>(options?:
 
 /**
  * Create a standalone campaign
- * Creates a campaign WITHOUT its first ad set / ad (the ODAX shell only). Ad sets join it
- * later via `existingCampaignId` on the create endpoints. A budget here is campaign-level
- * (CBO) by definition; omit it for ABO (each ad set carries its own budget). Created
- * `PAUSED` unless `status: ACTIVE`. The campaign materializes in `/v1/ads/tree` via the
- * next sync discovery pass.
+ * Creates a campaign WITHOUT its first ad set / ad, on the platform of the given
+ * `accountId`. Ad sets join it later via `existingCampaignId` on the create endpoints.
+ * Platform notes: on Meta a budget here is campaign-level (CBO) by definition; omit it
+ * for ABO (each ad set carries its own budget), and `specialAdCategories` /
+ * `bidStrategy` are Meta-only (400 elsewhere). Google, X and OpenAI require a budget
+ * (422 without one; OpenAI accepts only `budgetType: lifetime`). LinkedIn creates the
+ * campaign GROUP (our campaign level) and rejects a budget, which lives on the
+ * campaign (ad set) level there; it comes back `status: DRAFT`. TikTok campaigns are
+ * created without a status and report `ENABLE`. Created `PAUSED` unless
+ * `status: ACTIVE` where the platform supports it.
  *
  * **Idempotency:** send an `Idempotency-Key` header to make retries safe.
  */

package/src/generated/types.gen.ts

@@ -29997,11 +29997,11 @@ export type ListAdCampaignsError = (ErrorResponse | {
 export type CreateAdCampaignData = {
     body: {
         /**
-         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         * Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created.
          */
         accountId: string;
         /**
-         * Meta ad account id (act_<n>).
+         * Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...).
          */
         adAccountId: string;
         name: string;
@@ -31008,7 +31008,7 @@ export type GenerateAdPreviewsData = {
          */
         accountId: string;
         /**
-         * Meta ad account id (act_<n>).
+         * Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...).
          */
         adAccountId: string;
         /**
@@ -31726,7 +31726,7 @@ export type CreateRfPredictionData = {
          */
         accountId: string;
         /**
-         * Meta ad account id (act_<n>).
+         * Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...).
          */
         adAccountId: string;
         /**
@@ -32083,7 +32083,7 @@ export type CreateAdCreativeData = {
          */
         accountId: string;
         /**
-         * Meta ad account id (act_<n>).
+         * Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...).
          */
         adAccountId: string;
         headline: string;
@@ -32179,7 +32179,7 @@ export type GetAdCreativeError = (unknown | {
 export type UpdateAdCreativeData = {
     body: {
         /**
-         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         * Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created.
          */
         accountId: string;
         name: string;
@@ -32265,11 +32265,11 @@ export type ListValueRuleSetsError = (unknown | {
 export type CreateValueRuleSetData = {
     body: {
         /**
-         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         * Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created.
          */
         accountId: string;
         /**
-         * Meta ad account id (act_<n>).
+         * Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...).
          */
         adAccountId: string;
         name: string;
@@ -32318,7 +32318,7 @@ export type GetValueRuleSetError = (unknown | {
 export type UpdateValueRuleSetData = {
     body: {
         /**
-         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         * Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created.
          */
         accountId: string;
         /**
@@ -34431,11 +34431,11 @@ export type CreateTestLeadError = (ErrorResponse | {
 export type UploadAdImageData = {
     body: {
         /**
-         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         * Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created.
          */
         accountId: string;
         /**
-         * Meta ad account id (act_<n>).
+         * Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...).
          */
         adAccountId: string;
         /**
@@ -34512,11 +34512,11 @@ export type ListAdImagesError = (unknown | {
 export type UploadAdVideoData = {
     body: {
         /**
-         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         * Zernio SocialAccount id (posting or ads variant); its platform decides where the campaign is created.
          */
         accountId: string;
         /**
-         * Meta ad account id (act_<n>).
+         * Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...).
          */
         adAccountId: string;
         /**
@@ -36077,7 +36077,7 @@ export type ListCustomConversionsError = (unknown | {
 export type CreateCustomConversionData = {
     body: {
         /**
-         * Meta ad account id (act_<n>).
+         * Platform ad account id (Meta act_<n>, Google customer id, LinkedIn account id, ...).
          */
         adAccountId: string;
         /**