@getlatedev/node 0.2.399 → 0.2.401

package/src/generated/types.gen.ts

@@ -1722,6 +1722,38 @@ export type CtwaSingleResponse = {
 
 export type adType3 = 'single';
 
+/**
+ * A Discord guild member, returned verbatim from Discord's API.
+ */
+export type DiscordGuildMember = {
+    user?: {
+        /**
+         * User snowflake
+         */
+        id?: string;
+        username?: string;
+        discriminator?: string;
+        avatar?: (string) | null;
+        /**
+         * User's display name (post-2023 Discord rebrand)
+         */
+        global_name?: (string) | null;
+    };
+    /**
+     * Guild-specific nickname
+     */
+    nick?: (string) | null;
+    /**
+     * Snowflake IDs of roles assigned to this member
+     */
+    roles?: Array<(string)>;
+    joined_at?: string;
+    /**
+     * When the user started boosting the server
+     */
+    premium_since?: (string) | null;
+};
+
 /**
  * Discord message settings. Supports plain text (2,000 chars), rich embeds (up to 10), native polls, forum posts, threads, and announcement crossposts. Media attachments support images (JPEG, PNG, GIF, WebP), videos (MP4), and documents (up to 10 files, 25 MB each). Webhook identity (username + avatar) can be customized per-account via PATCH /v1/connect/discord or per-post via webhookUsername/webhookAvatarUrl.
  *
@@ -13625,34 +13657,7 @@ export type ListDiscordGuildMembersData = {
 };
 
 export type ListDiscordGuildMembersResponse = ({
-    data?: Array<{
-        user?: {
-            /**
-             * User snowflake
-             */
-            id?: string;
-            username?: string;
-            discriminator?: string;
-            avatar?: (string) | null;
-            /**
-             * User's display name (post-2023 Discord rebrand)
-             */
-            global_name?: (string) | null;
-        };
-        /**
-         * Guild-specific nickname
-         */
-        nick?: (string) | null;
-        /**
-         * Snowflake IDs of roles assigned to this member
-         */
-        roles?: Array<(string)>;
-        joined_at?: string;
-        /**
-         * When the user started boosting the server
-         */
-        premium_since?: (string) | null;
-    }>;
+    data?: Array<DiscordGuildMember>;
     pagination?: {
         /**
          * Pass as `after` on the next call. Null when there are no more pages.
@@ -13666,6 +13671,49 @@ export type ListDiscordGuildMembersError = (unknown | {
     error?: string;
 });
 
+export type SearchDiscordGuildMembersData = {
+    path: {
+        guildId: string;
+    };
+    query: {
+        accountId: string;
+        limit?: number;
+        /**
+         * Username or nickname prefix to match.
+         */
+        query: string;
+    };
+};
+
+export type SearchDiscordGuildMembersResponse = ({
+    data?: Array<DiscordGuildMember>;
+});
+
+export type SearchDiscordGuildMembersError = (unknown | {
+    error?: string;
+});
+
+export type GetDiscordGuildMemberData = {
+    path: {
+        guildId: string;
+        /**
+         * Discord user snowflake.
+         */
+        userId: string;
+    };
+    query: {
+        accountId: string;
+    };
+};
+
+export type GetDiscordGuildMemberResponse = ({
+    data?: DiscordGuildMember;
+});
+
+export type GetDiscordGuildMemberError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
 export type AddDiscordMemberRoleData = {
     path: {
         guildId: string;
@@ -17957,6 +18005,105 @@ export type ListSmsOptOutsError = ({
     error?: string;
 });
 
+export type CreateSmsSenderIdData = {
+    body: {
+        /**
+         * The sender ID recipients will see (3-11 letters/digits/spaces, at least one letter, no leading/trailing space).
+         */
+        senderId: string;
+    };
+};
+
+export type CreateSmsSenderIdResponse = ({
+    /**
+     * Sender ID resource id.
+     */
+    id?: string;
+    senderId?: string;
+    isActive?: boolean;
+});
+
+export type CreateSmsSenderIdError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type ListSmsSenderIdsResponse = ({
+    senderIds?: Array<{
+        id?: string;
+        senderId?: string;
+        isActive?: boolean;
+        createdAt?: (string) | null;
+    }>;
+    /**
+     * Workspace-wide daily sending budget, shared by every sender ID (resets midnight UTC).
+     */
+    budget?: {
+        /**
+         * Daily message cap (raisable via `/v1/sms/sender-ids/limit-request`).
+         */
+        cap?: number;
+        /**
+         * Messages already counted against today's cap.
+         */
+        usedToday?: number;
+        /**
+         * Cap tier (Level 1 = 500/day).
+         */
+        level?: number;
+        /**
+         * The in-flight cap-raise request awaiting review, or null. While set, further requests return 409.
+         */
+        pendingRequest?: {
+            requestedCap?: number;
+            level?: number;
+            requestedAt?: (string) | null;
+        } | null;
+    };
+});
+
+export type ListSmsSenderIdsError = ({
+    error?: string;
+});
+
+export type RequestSmsSenderIdLimitIncreaseData = {
+    body: {
+        /**
+         * Desired daily message cap. Must exceed the current cap.
+         */
+        requestedCap: number;
+        /**
+         * Use case and audience (what you send, to whom, opt-in status).
+         */
+        reason: string;
+    };
+};
+
+export type RequestSmsSenderIdLimitIncreaseResponse = ({
+    requested?: boolean;
+    requestedCap?: number;
+});
+
+export type RequestSmsSenderIdLimitIncreaseError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type DeleteSmsSenderIdData = {
+    path: {
+        /**
+         * Sender ID resource id.
+         */
+        id: string;
+    };
+};
+
+export type DeleteSmsSenderIdResponse = ({
+    deleted?: boolean;
+});
+
+export type DeleteSmsSenderIdError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
 export type StartSmsRegistrationData = {
     body: {
         registrationType: 'standard_10dlc' | 'sole_prop_10dlc' | 'toll_free';
@@ -23735,6 +23882,48 @@ export type ListAdCampaignsError = ({
     error?: string;
 } | unknown);
 
+export type CreateAdCampaignData = {
+    body: {
+        /**
+         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         */
+        accountId: string;
+        /**
+         * Meta ad account id (act_<n>).
+         */
+        adAccountId: string;
+        name: string;
+        /**
+         * Mapped to the ODAX objective (same mapping as POST /v1/ads/create).
+         */
+        goal: 'engagement' | 'traffic' | 'awareness' | 'video_views' | 'lead_generation' | 'lead_conversion' | 'job_applicants' | 'conversions' | 'app_promotion' | 'catalog_sales';
+        specialAdCategories?: Array<('HOUSING' | 'EMPLOYMENT' | 'CREDIT' | 'ISSUES_ELECTIONS_POLITICS' | 'FINANCIAL_PRODUCTS_SERVICES' | 'ONLINE_GAMBLING_AND_GAMING')>;
+        /**
+         * Campaign-level (CBO) budget in whole currency units. Requires budgetType.
+         */
+        budgetAmount?: number;
+        budgetType?: 'daily' | 'lifetime';
+        status?: 'ACTIVE' | 'PAUSED';
+    };
+};
+
+export type CreateAdCampaignResponse = ({
+    adAccountId?: string;
+    /**
+     * Platform id of the new campaign
+     */
+    campaignId?: string;
+    /**
+     * Resolved ODAX objective (e.g. OUTCOME_SALES).
+     */
+    objective?: string;
+    status?: 'ACTIVE' | 'PAUSED';
+});
+
+export type CreateAdCampaignError = (unknown | {
+    error?: string;
+});
+
 export type UpdateAdCampaignStatusData = {
     body: {
         status: 'active' | 'paused';
@@ -23926,6 +24115,89 @@ export type DuplicateAdCampaignError = (unknown | {
     error?: string;
 });
 
+export type DuplicateAdSetData = {
+    body: {
+        platform: 'facebook' | 'instagram';
+        /**
+         * Destination platform campaign id (defaults to the source's campaign)
+         */
+        campaignId?: string;
+        /**
+         * Copy child ads + creatives
+         */
+        deepCopy?: boolean;
+        statusOption?: 'ACTIVE' | 'PAUSED' | 'INHERITED_FROM_SOURCE';
+        /**
+         * Reschedule the copy's start time
+         */
+        startTime?: string;
+        endTime?: string;
+        renameStrategy?: 'DEEP_RENAME' | 'ONLY_TOP_LEVEL_RENAME' | 'NO_RENAME';
+        renamePrefix?: string;
+        renameSuffix?: string;
+        syncAfter?: boolean;
+    };
+    path: {
+        /**
+         * Source platform ad set ID
+         */
+        adSetId: string;
+    };
+};
+
+export type DuplicateAdSetResponse = ({
+    /**
+     * Platform ID of the new ad set
+     */
+    copiedAdSetId?: string;
+    discovery?: 'triggered' | 'skipped' | 'failed';
+    /**
+     * Meta's native copy response (includes ad_object_ids for child copies)
+     */
+    raw?: {
+        [key: string]: unknown;
+    };
+});
+
+export type DuplicateAdSetError = (unknown | {
+    error?: string;
+});
+
+export type DuplicateAdData = {
+    body?: {
+        /**
+         * Destination platform ad set id (defaults to the source's ad set)
+         */
+        adSetId?: string;
+        statusOption?: 'ACTIVE' | 'PAUSED' | 'INHERITED_FROM_SOURCE';
+        renameStrategy?: 'DEEP_RENAME' | 'ONLY_TOP_LEVEL_RENAME' | 'NO_RENAME';
+        renamePrefix?: string;
+        renameSuffix?: string;
+        syncAfter?: boolean;
+    };
+    path: {
+        /**
+         * Zernio ad ID or platform ad ID
+         */
+        adId: string;
+    };
+};
+
+export type DuplicateAdResponse = ({
+    /**
+     * Platform ID of the new ad
+     */
+    copiedAdId?: string;
+    discovery?: 'triggered' | 'skipped' | 'failed';
+    raw?: {
+        [key: string]: unknown;
+    };
+});
+
+export type DuplicateAdError = (unknown | {
+    error?: string;
+});
+
 export type GetAdSetDetailsData = {
     path: {
         /**
@@ -24021,7 +24293,7 @@ export type UpdateAdSetData = {
              */
             endDate?: string;
             /**
-             * Meta ad-set promoted_object, forwarded verbatim (same shape as /v1/ads/create).
+             * Meta ad-set promoted_object, forwarded verbatim (same shape as /v1/ads/create). Unknown keys are rejected with 400.
              */
             promotedObject?: {
                 pixelId?: string;
@@ -24032,6 +24304,8 @@ export type UpdateAdSetData = {
                 customConversionId?: string;
                 productCatalogId?: string;
                 productSetId?: string;
+                offlineConversionDataSetId?: string;
+                whatsappPhoneNumber?: string;
             };
         };
     };
@@ -25157,40 +25431,344 @@ export type ListAdStudiesError = (unknown | {
     error?: string;
 });
 
-export type GetAdAccountFinanceData = {
+export type ListMetaBusinessesData = {
     query: {
         /**
          * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
          */
         accountId: string;
         /**
-         * Meta ad account id (act_<n>).
+         * Cursor from paging.after of the previous page.
          */
-        adAccountId: string;
+        after?: string;
+        /**
+         * Rows per page
+         */
+        limit?: number;
     };
 };
 
-export type GetAdAccountFinanceResponse = ({
-    adAccountId?: string;
-    /**
-     * ISO 4217 code all money values are expressed in.
-     */
-    currency?: string;
-    /**
-     * Outstanding/prepaid balance in whole currency units.
-     */
-    balance?: number;
-    /**
-     * Lifetime amount spent in whole currency units.
-     */
-    amountSpent?: number;
-    /**
-     * Account spend cap; null when none is set.
-     */
-    spendCap?: (number) | null;
-    fundingSource?: {
-        /**
-         * Human-readable payment method, e.g. 'Mastercard *4985'.
+export type ListMetaBusinessesResponse = ({
+    data?: Array<{
+        [key: string]: unknown;
+    }>;
+    paging?: {
+        /**
+         * Cursor for the next page; null when exhausted.
+         */
+        after?: (string) | null;
+    };
+});
+
+export type ListMetaBusinessesError = (unknown | {
+    error?: string;
+});
+
+export type ListAdLabelsData = {
+    query: {
+        /**
+         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         */
+        accountId: string;
+        /**
+         * Meta ad account id (act_<n>).
+         */
+        adAccountId: string;
+        /**
+         * Cursor from paging.after of the previous page.
+         */
+        after?: string;
+        /**
+         * Rows per page
+         */
+        limit?: number;
+    };
+};
+
+export type ListAdLabelsResponse = ({
+    adAccountId?: string;
+    data?: Array<{
+        [key: string]: unknown;
+    }>;
+    paging?: {
+        /**
+         * Cursor for the next page; null when exhausted.
+         */
+        after?: (string) | null;
+    };
+});
+
+export type ListAdLabelsError = (unknown | {
+    error?: string;
+});
+
+export type ListHighDemandPeriodsData = {
+    query: {
+        /**
+         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         */
+        accountId: string;
+        /**
+         * Platform ad set id. Exactly one of campaignId / adSetId.
+         */
+        adSetId?: string;
+        /**
+         * Cursor from paging.after of the previous page.
+         */
+        after?: string;
+        /**
+         * Platform campaign id. Exactly one of campaignId / adSetId.
+         */
+        campaignId?: string;
+        /**
+         * Rows per page
+         */
+        limit?: number;
+    };
+};
+
+export type ListHighDemandPeriodsResponse = ({
+    /**
+     * The campaign / ad set id the schedules belong to.
+     */
+    objectId?: string;
+    data?: Array<{
+        [key: string]: unknown;
+    }>;
+    paging?: {
+        /**
+         * Cursor for the next page; null when exhausted.
+         */
+        after?: (string) | null;
+    };
+});
+
+export type ListHighDemandPeriodsError = (unknown | {
+    error?: string;
+});
+
+export type ListAdCreativesData = {
+    query: {
+        /**
+         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         */
+        accountId: string;
+        /**
+         * Meta ad account id (act_<n>).
+         */
+        adAccountId: string;
+        /**
+         * Cursor from paging.after of the previous page.
+         */
+        after?: string;
+        /**
+         * Comma-separated Graph field override (supports nested {} projections).
+         */
+        fields?: string;
+        /**
+         * Rows per page
+         */
+        limit?: number;
+    };
+};
+
+export type ListAdCreativesResponse = ({
+    adAccountId?: string;
+    data?: Array<{
+        [key: string]: unknown;
+    }>;
+    paging?: {
+        /**
+         * Cursor for the next page; null when exhausted.
+         */
+        after?: (string) | null;
+    };
+});
+
+export type ListAdCreativesError = (unknown | {
+    error?: string;
+});
+
+export type CreateAdCreativeData = {
+    body: {
+        /**
+         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token and Page.
+         */
+        accountId: string;
+        /**
+         * Meta ad account id (act_<n>).
+         */
+        adAccountId: string;
+        headline: string;
+        /**
+         * Primary text
+         */
+        body: string;
+        /**
+         * Link description below the headline; omitted = Meta scrapes the destination's OG description.
+         */
+        description?: string;
+        /**
+         * CTA type (same whitelist as POST /v1/ads/create).
+         */
+        callToAction?: string;
+        linkUrl: string;
+        /**
+         * Publicly reachable image; uploaded to the account's library server-side.
+         */
+        imageUrl?: string;
+        /**
+         * Existing library image hash (POST /v1/ads/images or GET /v1/ads/images).
+         */
+        imageHash?: string;
+        carouselCards?: Array<{
+            imageUrl: string;
+            linkUrl: string;
+            headline?: string;
+            description?: string;
+            callToAction?: string;
+        }>;
+        /**
+         * Appended to every outbound URL (e.g. utm_source=fb).
+         */
+        urlTags?: string;
+        /**
+         * Advantage+ creative enhancements: partial map of Meta creative feature keys (snake_case) to enroll status, forwarded as degrees_of_freedom_spec.creative_features_spec. Unspecified features default to OPT_OUT.
+         */
+        creativeFeatures?: {
+            [key: string]: ('OPT_IN' | 'OPT_OUT');
+        };
+    };
+};
+
+export type CreateAdCreativeResponse = ({
+    adAccountId?: string;
+    /**
+     * Platform creative id, reusable via existingCreativeId.
+     */
+    creativeId?: string;
+});
+
+export type CreateAdCreativeError = (unknown | {
+    error?: string;
+});
+
+export type GetAdCreativeData = {
+    path: {
+        /**
+         * Platform creative id
+         */
+        creativeId: string;
+    };
+    query: {
+        /**
+         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         */
+        accountId: string;
+        /**
+         * Comma-separated Graph field override (supports nested {} projections).
+         */
+        fields?: string;
+    };
+};
+
+export type GetAdCreativeResponse = ({
+    /**
+     * Raw Meta creative node
+     */
+    creative?: {
+        [key: string]: unknown;
+    };
+});
+
+export type GetAdCreativeError = (unknown | {
+    error?: string;
+});
+
+export type UpdateAdCreativeData = {
+    body: {
+        /**
+         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         */
+        accountId: string;
+        name: string;
+    };
+    path: {
+        /**
+         * Platform creative id
+         */
+        creativeId: string;
+    };
+};
+
+export type UpdateAdCreativeResponse = ({
+    creativeId?: string;
+    name?: string;
+    message?: string;
+});
+
+export type UpdateAdCreativeError = (unknown | {
+    error?: string;
+});
+
+export type DeleteAdCreativeData = {
+    path: {
+        /**
+         * Platform creative id
+         */
+        creativeId: string;
+    };
+    query: {
+        /**
+         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         */
+        accountId: string;
+    };
+};
+
+export type DeleteAdCreativeResponse = ({
+    creativeId?: string;
+    message?: string;
+});
+
+export type DeleteAdCreativeError = (unknown | {
+    error?: string;
+});
+
+export type GetAdAccountFinanceData = {
+    query: {
+        /**
+         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         */
+        accountId: string;
+        /**
+         * Meta ad account id (act_<n>).
+         */
+        adAccountId: string;
+    };
+};
+
+export type GetAdAccountFinanceResponse = ({
+    adAccountId?: string;
+    /**
+     * ISO 4217 code all money values are expressed in.
+     */
+    currency?: string;
+    /**
+     * Outstanding/prepaid balance in whole currency units.
+     */
+    balance?: number;
+    /**
+     * Lifetime amount spent in whole currency units.
+     */
+    amountSpent?: number;
+    /**
+     * Account spend cap; null when none is set.
+     */
+    spendCap?: (number) | null;
+    fundingSource?: {
+        /**
+         * Human-readable payment method, e.g. 'Mastercard *4985'.
          */
         displayString?: string;
         /**
@@ -25507,6 +26085,10 @@ export type BoostPostData = {
          * Meta only. Required for housing, employment, credit, or political ads.
          */
         specialAdCategories?: Array<('HOUSING' | 'EMPLOYMENT' | 'CREDIT' | 'FINANCIAL_PRODUCTS_SERVICES' | 'ISSUES_ELECTIONS_POLITICS' | 'ONLINE_GAMBLING_AND_GAMING')>;
+        /**
+         * Meta (metaads) only. 2-letter ISO country codes the special ad category applies to. Requires specialAdCategories to be set (400 otherwise).
+         */
+        specialAdCategoryCountry?: Array<(string)>;
         /**
          * TikTok-only. Custom destination URL for the Spark Ad. Without this, TikTok
          * Spark Ads have no clickable destination — required for traffic / conversion
@@ -25632,6 +26214,16 @@ export type CreateStandaloneAdData = {
          * Meta only. The RESERVED prediction id the R&F ad set runs on (reserving mints a new id — pass that one). Requires buyingType RESERVED.
          */
         rfPredictionId?: string;
+        /**
+         * Meta only. Advantage+ creative enhancements: a partial map of Meta creative feature keys (snake_case, e.g. enhance_cta, image_brightness_and_contrast, text_optimizations) to enroll status, forwarded as degrees_of_freedom_spec.creative_features_spec. Meta validates the keys; unspecified features default to OPT_OUT. The legacy standard_enhancements bundle is deprecated by Meta and rejected.
+         */
+        creativeFeatures?: {
+            [key: string]: ('OPT_IN' | 'OPT_OUT');
+        };
+        /**
+         * Meta only, single standalone shape only (no creatives[], adSetId, or RESERVED). Dry-run: each node runs Meta's execution_options validate_only and NOTHING is created or persisted. Children need real parents, so a fresh tree validates the campaign + creative (the ad set needs its campaign to exist — pass existingCampaignId to validate it too; the ad itself is never validatable pre-create). A Meta validation failure returns the 400 verbatim; success returns 200 with per-node results instead of an ad.
+         */
+        validateOnly?: boolean;
         /**
          * Required on legacy + multi-creative shapes. Inherited on attach.
          */
@@ -25968,6 +26560,13 @@ export type CreateStandaloneAdData = {
          *
          */
         specialAdCategories?: Array<('HOUSING' | 'EMPLOYMENT' | 'CREDIT' | 'FINANCIAL_PRODUCTS_SERVICES' | 'ISSUES_ELECTIONS_POLITICS' | 'ONLINE_GAMBLING_AND_GAMING')>;
+        /**
+         * Meta (metaads) only. 2-letter ISO country codes the special ad category applies to. Requires
+         * specialAdCategories to be set (400 otherwise). Ignored when joining an existing campaign via
+         * existingCampaignId (the existing campaign's category/country already governs it).
+         *
+         */
+        specialAdCategoryCountry?: Array<(string)>;
         /**
          * Required for lifetime budgets
          */
@@ -26331,6 +26930,14 @@ export type CreateStandaloneAdData = {
              * Product Set ID inside the catalog.
              */
             productSetId?: string;
+            /**
+             * Meta only. Offline event set (dataset) to optimise toward. Post-merger these are datasets: the id is the dataset id (for pixel-backed datasets, the pixel id).
+             */
+            offlineConversionDataSetId?: string;
+            /**
+             * Meta only. WhatsApp number on messaging-destination ad sets.
+             */
+            whatsappPhoneNumber?: string;
         };
     };
     headers?: {
@@ -26341,7 +26948,18 @@ export type CreateStandaloneAdData = {
     };
 };
 
-export type CreateStandaloneAdResponse = (({
+export type CreateStandaloneAdResponse = ({
+    validateOnly?: boolean;
+    results?: Array<{
+        node?: 'campaign' | 'adSet' | 'creative' | 'ad';
+        status?: 'validated' | 'skipped';
+        /**
+         * Why the node could not be validated (only on skipped).
+         */
+        reason?: string;
+    }>;
+    message?: string;
+} | ({
     ad?: Ad;
     message?: string;
 } | {
@@ -26637,6 +27255,48 @@ export type UploadAdImageError = (unknown | {
     error?: string;
 });
 
+export type ListAdImagesData = {
+    query: {
+        /**
+         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         */
+        accountId: string;
+        /**
+         * Meta ad account id (act_<n>).
+         */
+        adAccountId: string;
+        /**
+         * Cursor from paging.after of the previous page.
+         */
+        after?: string;
+        /**
+         * Comma-separated Graph field override (supports nested {} projections).
+         */
+        fields?: string;
+        /**
+         * Rows per page
+         */
+        limit?: number;
+    };
+};
+
+export type ListAdImagesResponse = ({
+    adAccountId?: string;
+    data?: Array<{
+        [key: string]: unknown;
+    }>;
+    paging?: {
+        /**
+         * Cursor for the next page; null when exhausted.
+         */
+        after?: (string) | null;
+    };
+});
+
+export type ListAdImagesError = (unknown | {
+    error?: string;
+});
+
 export type SearchAdInterestsData = {
     query: {
         /**
@@ -26990,7 +27650,7 @@ export type ListAdAudiencesData = {
         /**
          * Filter to one audience type. `saved_targeting` returns stored TargetingSpec audiences; the other types return uploaded/derived audiences.
          */
-        type?: 'customer_list' | 'company_list' | 'engagement' | 'website' | 'website_retargeting' | 'lookalike' | 'saved_targeting';
+        type?: 'customer_list' | 'company_list' | 'engagement' | 'meta_engagement' | 'website' | 'website_retargeting' | 'lookalike' | 'saved_targeting';
     };
 };
 
@@ -27004,7 +27664,7 @@ export type ListAdAudiencesResponse = ({
         platformAudienceId?: string;
         name?: string;
         description?: string;
-        type?: 'customer_list' | 'company_list' | 'engagement' | 'website' | 'website_retargeting' | 'lookalike' | 'saved_targeting';
+        type?: 'customer_list' | 'company_list' | 'engagement' | 'meta_engagement' | 'website' | 'website_retargeting' | 'lookalike' | 'saved_targeting';
         /**
          * Present (and the only meaningful payload) when `type` is `saved_targeting`. Null for uploaded/derived audience types.
          */
@@ -27028,7 +27688,7 @@ export type CreateAdAudienceData = {
     adAccountId: string;
     name: string;
     description?: string;
-    type: 'customer_list' | 'company_list' | 'engagement' | 'website' | 'website_retargeting' | 'lookalike';
+    type: 'customer_list' | 'company_list' | 'engagement' | 'meta_engagement' | 'website' | 'website_retargeting' | 'lookalike';
     /**
      * Required for website_retargeting audiences (LinkedIn only).
      * Each rule is a URL pattern; a member who visits any
@@ -27093,9 +27753,29 @@ export type CreateAdAudienceData = {
      */
     pixelId?: string;
     /**
-     * Required for website audiences
+     * Required for website (max 180) and meta_engagement (max 365) audiences.
      */
     retentionDays?: number;
+    /**
+     * Required for meta_engagement audiences (Meta only): what people
+     * engaged with. `page` = a Facebook Page, `instagram` = an IG
+     * professional account, `video` = a video. The source object must be
+     * eligible for engagement audiences or Meta rejects with subcode
+     * 1713151 ("Invalid Event Name"), surfaced verbatim.
+     *
+     */
+    engagementSource?: 'page' | 'instagram' | 'video';
+    /**
+     * Required for meta_engagement: the Page / IG account / video id.
+     */
+    sourceId?: string;
+    /**
+     * meta_engagement only. The engagement event; defaults per source
+     * (page → page_engaged, instagram → ig_business_profile_all,
+     * video → video_watched). Ignored when `rule` is provided.
+     *
+     */
+    event?: string;
     /**
      * Required for lookalike audiences
      */
@@ -27109,7 +27789,7 @@ export type CreateAdAudienceData = {
      */
     ratio?: number;
     /**
-     * Pixel event rule for website audiences (optional)
+     * Optional raw Meta rule, forwarded verbatim: pixel event rule for website audiences, or the engagement rule for meta_engagement (overrides the built rule, e.g. for event/canvas/lead-form sources).
      */
     rule?: {
         [key: string]: unknown;