@zernio/node 0.2.79 → 0.2.81

package/dist/index.d.mts

@@ -12166,14 +12166,20 @@ type CreateStandaloneAdData = {
         adAccountId: string;
         name: string;
         /**
-         * Available goals vary by platform. Meta (Facebook/Instagram) and TikTok support all 7. LinkedIn supports all except app_promotion. Twitter/X supports engagement, traffic, awareness, video_views, app_promotion. Pinterest and Google Ads support only engagement, traffic, awareness, video_views.
+         * Required on legacy + multi-creative shapes. Inherited from the ad set on the attach shape. Available goals vary by platform.
          */
-        goal: 'engagement' | 'traffic' | 'awareness' | 'video_views' | 'lead_generation' | 'conversions' | 'app_promotion';
-        budgetAmount: number;
-        budgetType: 'daily' | 'lifetime';
+        goal?: 'engagement' | 'traffic' | 'awareness' | 'video_views' | 'lead_generation' | 'conversions' | 'app_promotion';
+        /**
+         * Required on legacy + multi-creative shapes. Inherited on attach.
+         */
+        budgetAmount?: number;
+        /**
+         * Required on legacy + multi-creative shapes. Inherited on attach.
+         */
+        budgetType?: 'daily' | 'lifetime';
         currency?: string;
         /**
-         * Required for most platforms. Max: Meta=255, Google=30, Pinterest=100
+         * Required on legacy + attach shapes (skip for multi-creative — use `creatives[].headline`). Max: Meta=255, Google=30, Pinterest=100
          */
         headline?: string;
         /**
@@ -12181,18 +12187,43 @@ type CreateStandaloneAdData = {
          */
         longHeadline?: string;
         /**
-         * Max: Google=90, Pinterest=500
+         * Required on legacy + attach shapes. Max: Google=90, Pinterest=500
          */
-        body: string;
+        body?: string;
         /**
-         * Meta only
+         * Required on legacy + attach shapes. Meta only.
          */
         callToAction?: 'LEARN_MORE' | 'SHOP_NOW' | 'SIGN_UP' | 'BOOK_TRAVEL' | 'CONTACT_US' | 'DOWNLOAD' | 'GET_OFFER' | 'GET_QUOTE' | 'SUBSCRIBE' | 'WATCH_MORE';
+        /**
+         * Required on legacy + attach shapes. Skip for multi-creative.
+         */
         linkUrl?: string;
         /**
-         * Image URL (or video URL for TikTok). Not required for Google Search campaigns.
+         * Required on legacy + attach shapes. Not required for Google Search campaigns.
          */
         imageUrl?: string;
+        /**
+         * Meta-only. When present, switches to the multi-creative shape:
+         * creates 1 campaign + 1 ad set + N ads (one per entry here).
+         * Top-level `headline` / `body` / `imageUrl` / `linkUrl` /
+         * `callToAction` are ignored in this mode. Mutually exclusive with `adSetId`.
+         *
+         */
+        creatives?: Array<{
+            headline: string;
+            body: string;
+            imageUrl: string;
+            linkUrl: string;
+            callToAction: 'LEARN_MORE' | 'SHOP_NOW' | 'SIGN_UP' | 'BOOK_TRAVEL' | 'CONTACT_US' | 'DOWNLOAD' | 'GET_OFFER' | 'GET_QUOTE' | 'SUBSCRIBE' | 'WATCH_MORE';
+        }>;
+        /**
+         * Meta-only. When present, switches to the attach shape: adds
+         * one new ad to this existing ad set without creating a new
+         * campaign. Budget, targeting, goal, and schedule are inherited
+         * from the ad set on Meta. Mutually exclusive with `creatives[]`.
+         *
+         */
+        adSetId?: string;
         /**
          * Google Display only
          */
@@ -12241,10 +12272,15 @@ type CreateStandaloneAdData = {
         advantageAudience?: 0 | 1;
     };
 };
-type CreateStandaloneAdResponse = ({
+type CreateStandaloneAdResponse = (({
     ad?: Ad;
     message?: string;
-});
+} | {
+    ads?: Array<Ad>;
+    platformCampaignId?: string;
+    platformAdSetId?: string;
+    message?: string;
+}));
 type CreateStandaloneAdError = (unknown | {
     error?: string;
 });

package/dist/index.d.ts

@@ -12166,14 +12166,20 @@ type CreateStandaloneAdData = {
         adAccountId: string;
         name: string;
         /**
-         * Available goals vary by platform. Meta (Facebook/Instagram) and TikTok support all 7. LinkedIn supports all except app_promotion. Twitter/X supports engagement, traffic, awareness, video_views, app_promotion. Pinterest and Google Ads support only engagement, traffic, awareness, video_views.
+         * Required on legacy + multi-creative shapes. Inherited from the ad set on the attach shape. Available goals vary by platform.
          */
-        goal: 'engagement' | 'traffic' | 'awareness' | 'video_views' | 'lead_generation' | 'conversions' | 'app_promotion';
-        budgetAmount: number;
-        budgetType: 'daily' | 'lifetime';
+        goal?: 'engagement' | 'traffic' | 'awareness' | 'video_views' | 'lead_generation' | 'conversions' | 'app_promotion';
+        /**
+         * Required on legacy + multi-creative shapes. Inherited on attach.
+         */
+        budgetAmount?: number;
+        /**
+         * Required on legacy + multi-creative shapes. Inherited on attach.
+         */
+        budgetType?: 'daily' | 'lifetime';
         currency?: string;
         /**
-         * Required for most platforms. Max: Meta=255, Google=30, Pinterest=100
+         * Required on legacy + attach shapes (skip for multi-creative — use `creatives[].headline`). Max: Meta=255, Google=30, Pinterest=100
          */
         headline?: string;
         /**
@@ -12181,18 +12187,43 @@ type CreateStandaloneAdData = {
          */
         longHeadline?: string;
         /**
-         * Max: Google=90, Pinterest=500
+         * Required on legacy + attach shapes. Max: Google=90, Pinterest=500
          */
-        body: string;
+        body?: string;
         /**
-         * Meta only
+         * Required on legacy + attach shapes. Meta only.
          */
         callToAction?: 'LEARN_MORE' | 'SHOP_NOW' | 'SIGN_UP' | 'BOOK_TRAVEL' | 'CONTACT_US' | 'DOWNLOAD' | 'GET_OFFER' | 'GET_QUOTE' | 'SUBSCRIBE' | 'WATCH_MORE';
+        /**
+         * Required on legacy + attach shapes. Skip for multi-creative.
+         */
         linkUrl?: string;
         /**
-         * Image URL (or video URL for TikTok). Not required for Google Search campaigns.
+         * Required on legacy + attach shapes. Not required for Google Search campaigns.
          */
         imageUrl?: string;
+        /**
+         * Meta-only. When present, switches to the multi-creative shape:
+         * creates 1 campaign + 1 ad set + N ads (one per entry here).
+         * Top-level `headline` / `body` / `imageUrl` / `linkUrl` /
+         * `callToAction` are ignored in this mode. Mutually exclusive with `adSetId`.
+         *
+         */
+        creatives?: Array<{
+            headline: string;
+            body: string;
+            imageUrl: string;
+            linkUrl: string;
+            callToAction: 'LEARN_MORE' | 'SHOP_NOW' | 'SIGN_UP' | 'BOOK_TRAVEL' | 'CONTACT_US' | 'DOWNLOAD' | 'GET_OFFER' | 'GET_QUOTE' | 'SUBSCRIBE' | 'WATCH_MORE';
+        }>;
+        /**
+         * Meta-only. When present, switches to the attach shape: adds
+         * one new ad to this existing ad set without creating a new
+         * campaign. Budget, targeting, goal, and schedule are inherited
+         * from the ad set on Meta. Mutually exclusive with `creatives[]`.
+         *
+         */
+        adSetId?: string;
         /**
          * Google Display only
          */
@@ -12241,10 +12272,15 @@ type CreateStandaloneAdData = {
         advantageAudience?: 0 | 1;
     };
 };
-type CreateStandaloneAdResponse = ({
+type CreateStandaloneAdResponse = (({
     ad?: Ad;
     message?: string;
-});
+} | {
+    ads?: Array<Ad>;
+    platformCampaignId?: string;
+    platformAdSetId?: string;
+    message?: string;
+}));
 type CreateStandaloneAdError = (unknown | {
     error?: string;
 });

package/package.json

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

package/src/generated/sdk.gen.ts

@@ -2238,6 +2238,8 @@ export const releaseWhatsAppPhoneNumber = <ThrowOnError extends boolean = false>
  * List active WhatsApp group chats for a business phone number.
  * These are actual WhatsApp group conversations on the platform.
  *
+ * Not available on [Coexistence](/platforms/whatsapp#whatsapp-business-app-coexistence) numbers. Requires a Cloud API-only number.
+ *
  */
 export const listWhatsAppGroupChats = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<ListWhatsAppGroupChatsData, ThrowOnError>) => {
     return (options?.client ?? client).get<ListWhatsAppGroupChatsResponse, ListWhatsAppGroupChatsError, ThrowOnError>({
@@ -2250,6 +2252,8 @@ export const listWhatsAppGroupChats = <ThrowOnError extends boolean = false>(opt
  * Create group
  * Create a new WhatsApp group chat. Returns the group ID and optionally an invite link.
  *
+ * Not available on [Coexistence](/platforms/whatsapp#whatsapp-business-app-coexistence) numbers. Requires a Cloud API-only number.
+ *
  */
 export const createWhatsAppGroupChat = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<CreateWhatsAppGroupChatData, ThrowOnError>) => {
     return (options?.client ?? client).post<CreateWhatsAppGroupChatResponse, CreateWhatsAppGroupChatError, ThrowOnError>({
@@ -2263,6 +2267,8 @@ export const createWhatsAppGroupChat = <ThrowOnError extends boolean = false>(op
  * Retrieve metadata about a WhatsApp group including subject, description,
  * participants, and settings.
  *
+ * Not available on [Coexistence](/platforms/whatsapp#whatsapp-business-app-coexistence) numbers. Requires a Cloud API-only number.
+ *
  */
 export const getWhatsAppGroupChat = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetWhatsAppGroupChatData, ThrowOnError>) => {
     return (options?.client ?? client).get<GetWhatsAppGroupChatResponse, GetWhatsAppGroupChatError, ThrowOnError>({
@@ -2275,6 +2281,8 @@ export const getWhatsAppGroupChat = <ThrowOnError extends boolean = false>(optio
  * Update group settings
  * Update the subject, description, or join approval mode of a WhatsApp group.
  *
+ * Not available on [Coexistence](/platforms/whatsapp#whatsapp-business-app-coexistence) numbers. Requires a Cloud API-only number.
+ *
  */
 export const updateWhatsAppGroupChat = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<UpdateWhatsAppGroupChatData, ThrowOnError>) => {
     return (options?.client ?? client).post<UpdateWhatsAppGroupChatResponse, UpdateWhatsAppGroupChatError, ThrowOnError>({
@@ -2287,6 +2295,8 @@ export const updateWhatsAppGroupChat = <ThrowOnError extends boolean = false>(op
  * Delete group
  * Delete a WhatsApp group and remove all participants.
  *
+ * Not available on [Coexistence](/platforms/whatsapp#whatsapp-business-app-coexistence) numbers. Requires a Cloud API-only number.
+ *
  */
 export const deleteWhatsAppGroupChat = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<DeleteWhatsAppGroupChatData, ThrowOnError>) => {
     return (options?.client ?? client).delete<DeleteWhatsAppGroupChatResponse, DeleteWhatsAppGroupChatError, ThrowOnError>({
@@ -2299,6 +2309,8 @@ export const deleteWhatsAppGroupChat = <ThrowOnError extends boolean = false>(op
  * Add participants
  * Add participants to a WhatsApp group. Maximum 8 participants per request.
  *
+ * Not available on [Coexistence](/platforms/whatsapp#whatsapp-business-app-coexistence) numbers. Requires a Cloud API-only number.
+ *
  */
 export const addWhatsAppGroupParticipants = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<AddWhatsAppGroupParticipantsData, ThrowOnError>) => {
     return (options?.client ?? client).post<AddWhatsAppGroupParticipantsResponse, AddWhatsAppGroupParticipantsError, ThrowOnError>({
@@ -2311,6 +2323,8 @@ export const addWhatsAppGroupParticipants = <ThrowOnError extends boolean = fals
  * Remove participants
  * Remove participants from a WhatsApp group.
  *
+ * Not available on [Coexistence](/platforms/whatsapp#whatsapp-business-app-coexistence) numbers. Requires a Cloud API-only number.
+ *
  */
 export const removeWhatsAppGroupParticipants = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<RemoveWhatsAppGroupParticipantsData, ThrowOnError>) => {
     return (options?.client ?? client).delete<RemoveWhatsAppGroupParticipantsResponse, RemoveWhatsAppGroupParticipantsError, ThrowOnError>({
@@ -2323,6 +2337,8 @@ export const removeWhatsAppGroupParticipants = <ThrowOnError extends boolean = f
  * Create invite link
  * Create a new invite link for a WhatsApp group. The previous link is revoked.
  *
+ * Not available on [Coexistence](/platforms/whatsapp#whatsapp-business-app-coexistence) numbers. Requires a Cloud API-only number.
+ *
  */
 export const createWhatsAppGroupInviteLink = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<CreateWhatsAppGroupInviteLinkData, ThrowOnError>) => {
     return (options?.client ?? client).post<CreateWhatsAppGroupInviteLinkResponse, CreateWhatsAppGroupInviteLinkError, ThrowOnError>({
@@ -2335,6 +2351,8 @@ export const createWhatsAppGroupInviteLink = <ThrowOnError extends boolean = fal
  * List join requests
  * List pending join requests for a WhatsApp group (only for groups with approval_required mode).
  *
+ * Not available on [Coexistence](/platforms/whatsapp#whatsapp-business-app-coexistence) numbers. Requires a Cloud API-only number.
+ *
  */
 export const listWhatsAppGroupJoinRequests = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<ListWhatsAppGroupJoinRequestsData, ThrowOnError>) => {
     return (options?.client ?? client).get<ListWhatsAppGroupJoinRequestsResponse, ListWhatsAppGroupJoinRequestsError, ThrowOnError>({
@@ -2347,6 +2365,8 @@ export const listWhatsAppGroupJoinRequests = <ThrowOnError extends boolean = fal
  * Approve join requests
  * Approve pending join requests for a WhatsApp group.
  *
+ * Not available on [Coexistence](/platforms/whatsapp#whatsapp-business-app-coexistence) numbers. Requires a Cloud API-only number.
+ *
  */
 export const approveWhatsAppGroupJoinRequests = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<ApproveWhatsAppGroupJoinRequestsData, ThrowOnError>) => {
     return (options?.client ?? client).post<ApproveWhatsAppGroupJoinRequestsResponse, ApproveWhatsAppGroupJoinRequestsError, ThrowOnError>({
@@ -2359,6 +2379,8 @@ export const approveWhatsAppGroupJoinRequests = <ThrowOnError extends boolean =
  * Reject join requests
  * Reject pending join requests for a WhatsApp group.
  *
+ * Not available on [Coexistence](/platforms/whatsapp#whatsapp-business-app-coexistence) numbers. Requires a Cloud API-only number.
+ *
  */
 export const rejectWhatsAppGroupJoinRequests = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<RejectWhatsAppGroupJoinRequestsData, ThrowOnError>) => {
     return (options?.client ?? client).delete<RejectWhatsAppGroupJoinRequestsResponse, RejectWhatsAppGroupJoinRequestsError, ThrowOnError>({
@@ -3158,7 +3180,14 @@ export const boostPost = <ThrowOnError extends boolean = false>(options: Options
 
 /**
  * Create standalone ad
- * Creates a paid ad with custom creative (headline, body, image/video, link). Creates the full platform campaign hierarchy.
+ * Creates a paid ad with custom creative. The request body supports three mutually-exclusive shapes:
+ *
+ * 1. **Legacy single-creative** (all platforms). Top-level `headline` + `body` + `imageUrl` + `linkUrl` + `callToAction` create 1 campaign + 1 ad set + 1 ad.
+ * 2. **Multi-creative** (Meta only — use `creatives[]` array). Creates 1 campaign + 1 ad set + N ads sharing the same budget / targeting / schedule. This is the standard performance-marketing creative-testing flow — Meta's delivery algorithm A/B tests the creatives inside a single ad set so budget isn't fragmented across N parallel campaigns.
+ * 3. **Attach to existing ad set** (Meta only — pass `adSetId` + a single creative). Adds one new ad to an existing ad set without creating a new campaign. Budget, targeting, goal are inherited from the ad set on Meta.
+ *
+ * `creatives[]` and `adSetId` are mutually exclusive; specifying both returns 400.
+ *
  */
 export const createStandaloneAd = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<CreateStandaloneAdData, ThrowOnError>) => {
     return (options?.client ?? client).post<CreateStandaloneAdResponse, CreateStandaloneAdError, ThrowOnError>({

package/src/generated/types.gen.ts

@@ -12476,14 +12476,20 @@ export type CreateStandaloneAdData = {
         adAccountId: string;
         name: string;
         /**
-         * Available goals vary by platform. Meta (Facebook/Instagram) and TikTok support all 7. LinkedIn supports all except app_promotion. Twitter/X supports engagement, traffic, awareness, video_views, app_promotion. Pinterest and Google Ads support only engagement, traffic, awareness, video_views.
+         * Required on legacy + multi-creative shapes. Inherited from the ad set on the attach shape. Available goals vary by platform.
          */
-        goal: 'engagement' | 'traffic' | 'awareness' | 'video_views' | 'lead_generation' | 'conversions' | 'app_promotion';
-        budgetAmount: number;
-        budgetType: 'daily' | 'lifetime';
+        goal?: 'engagement' | 'traffic' | 'awareness' | 'video_views' | 'lead_generation' | 'conversions' | 'app_promotion';
+        /**
+         * Required on legacy + multi-creative shapes. Inherited on attach.
+         */
+        budgetAmount?: number;
+        /**
+         * Required on legacy + multi-creative shapes. Inherited on attach.
+         */
+        budgetType?: 'daily' | 'lifetime';
         currency?: string;
         /**
-         * Required for most platforms. Max: Meta=255, Google=30, Pinterest=100
+         * Required on legacy + attach shapes (skip for multi-creative — use `creatives[].headline`). Max: Meta=255, Google=30, Pinterest=100
          */
         headline?: string;
         /**
@@ -12491,18 +12497,43 @@ export type CreateStandaloneAdData = {
          */
         longHeadline?: string;
         /**
-         * Max: Google=90, Pinterest=500
+         * Required on legacy + attach shapes. Max: Google=90, Pinterest=500
          */
-        body: string;
+        body?: string;
         /**
-         * Meta only
+         * Required on legacy + attach shapes. Meta only.
          */
         callToAction?: 'LEARN_MORE' | 'SHOP_NOW' | 'SIGN_UP' | 'BOOK_TRAVEL' | 'CONTACT_US' | 'DOWNLOAD' | 'GET_OFFER' | 'GET_QUOTE' | 'SUBSCRIBE' | 'WATCH_MORE';
+        /**
+         * Required on legacy + attach shapes. Skip for multi-creative.
+         */
         linkUrl?: string;
         /**
-         * Image URL (or video URL for TikTok). Not required for Google Search campaigns.
+         * Required on legacy + attach shapes. Not required for Google Search campaigns.
          */
         imageUrl?: string;
+        /**
+         * Meta-only. When present, switches to the multi-creative shape:
+         * creates 1 campaign + 1 ad set + N ads (one per entry here).
+         * Top-level `headline` / `body` / `imageUrl` / `linkUrl` /
+         * `callToAction` are ignored in this mode. Mutually exclusive with `adSetId`.
+         *
+         */
+        creatives?: Array<{
+            headline: string;
+            body: string;
+            imageUrl: string;
+            linkUrl: string;
+            callToAction: 'LEARN_MORE' | 'SHOP_NOW' | 'SIGN_UP' | 'BOOK_TRAVEL' | 'CONTACT_US' | 'DOWNLOAD' | 'GET_OFFER' | 'GET_QUOTE' | 'SUBSCRIBE' | 'WATCH_MORE';
+        }>;
+        /**
+         * Meta-only. When present, switches to the attach shape: adds
+         * one new ad to this existing ad set without creating a new
+         * campaign. Budget, targeting, goal, and schedule are inherited
+         * from the ad set on Meta. Mutually exclusive with `creatives[]`.
+         *
+         */
+        adSetId?: string;
         /**
          * Google Display only
          */
@@ -12552,10 +12583,15 @@ export type CreateStandaloneAdData = {
     };
 };
 
-export type CreateStandaloneAdResponse = ({
+export type CreateStandaloneAdResponse = (({
     ad?: Ad;
     message?: string;
-});
+} | {
+    ads?: Array<Ad>;
+    platformCampaignId?: string;
+    platformAdSetId?: string;
+    message?: string;
+}));
 
 export type CreateStandaloneAdError = (unknown | {
     error?: string;