@getlatedev/node 0.2.388 → 0.2.390

package/src/generated/types.gen.ts

@@ -1372,6 +1372,313 @@ export type ConversionEvent = {
  */
 export type actionSource = 'web' | 'app' | 'offline' | 'crm' | 'phone_call' | 'system_generated';
 
+/**
+ * In addition to the `required` list, the request must use
+ * EXACTLY ONE of the two shapes:
+ *
+ * - Single-creative: `headline`, `body`, and one of
+ * `imageUrl` / `video` (mutually exclusive).
+ * - Multi-creative: a non-empty `creatives[]` array. Top-level
+ * `headline` / `body` / `imageUrl` / `video` must NOT be set
+ * on this shape.
+ *
+ * The route enforces this at the Zod boundary; OpenAPI's
+ * `required` cannot express the OR cleanly.
+ *
+ */
+export type CtwaAdRequestBody = {
+    /**
+     * Facebook or Instagram SocialAccount ID.
+     */
+    accountId: string;
+    /**
+     * Meta ad account ID, e.g. `act_123456789`.
+     */
+    adAccountId: string;
+    /**
+     * Ad display name. Used to derive campaign / ad set names.
+     * On the multi-creative shape, each ad's Meta name gets a
+     * " #N" suffix (1-indexed) so Ads Manager shows them as a
+     * numbered batch.
+     *
+     */
+    name: string;
+    /**
+     * Single-creative shape only. Mutually exclusive with
+     * `creatives[]`.
+     *
+     */
+    headline?: string;
+    /**
+     * Primary text shown above the image / video. Single-creative
+     * shape only. Mutually exclusive with `creatives[]`.
+     *
+     */
+    body?: string;
+    /**
+     * Image asset for single-creative shape. Mutually exclusive
+     * with `video` and with `creatives[]`. Required on the
+     * single-creative shape if `video` is not supplied.
+     *
+     */
+    imageUrl?: string;
+    /**
+     * Video creative for single-creative shape. Mutually
+     * exclusive with `imageUrl` and with `creatives[]`. Required
+     * on the single-creative shape if `imageUrl` is not supplied.
+     *
+     */
+    video?: {
+        url: string;
+        /**
+         * Required by Meta for every video creative. Used as the
+         * ad thumbnail.
+         *
+         */
+        thumbnailUrl: string;
+    };
+    /**
+     * Multi-creative shape: N CTWA ads under one campaign + one
+     * ad set, sharing budget and targeting. Mutually exclusive
+     * with the top-level single-creative fields (`headline` /
+     * `body` / `imageUrl` / `video`). Each entry must supply its
+     * own headline, body, and exactly one of `imageUrl` /
+     * `video`.
+     *
+     */
+    creatives?: Array<{
+        headline: string;
+        /**
+         * Primary text shown above the image / video.
+         */
+        body: string;
+        /**
+         * Image asset. Mutually exclusive with this entry's
+         * `video`. Required if `video` is not supplied.
+         *
+         */
+        imageUrl?: string;
+        /**
+         * Video creative. Mutually exclusive with this entry's
+         * `imageUrl`. Required if `imageUrl` is not supplied.
+         *
+         */
+        video?: {
+            url: string;
+            /**
+             * Required by Meta for every video creative. Used
+             * as the ad thumbnail.
+             *
+             */
+            thumbnailUrl: string;
+        };
+    }>;
+    /**
+     * Budget amount in the ad account's currency major units
+     * (e.g. dollars for USD, not cents). Must be > 0.
+     *
+     */
+    budgetAmount: number;
+    budgetType: 'daily' | 'lifetime';
+    /**
+     * ISO 4217 currency code matching the ad account's currency
+     * (e.g. `USD`). Optional; Meta infers from the ad account
+     * when omitted.
+     *
+     */
+    currency?: string;
+    /**
+     * ISO 8601 datetime. Required when `budgetType` is `lifetime`.
+     *
+     */
+    endDate?: string;
+    /**
+     * ISO 3166-1 alpha-2 country codes. Defaults to `["US"]` only
+     * when no other geo (`cities`, `regions`, `zips`, `metros`,
+     * `customLocations`) is supplied.
+     *
+     */
+    countries?: Array<(string)>;
+    /**
+     * City-level geo targeting for local CTWA campaigns. Each entry maps to Meta's
+     * TargetingGeoLocationCity. `key` is Meta's city ID. `radius`
+     * and `distance_unit` are coupled: set both or neither.
+     * Meta enforces a minimum city radius (~17 km / 10 mi);
+     * smaller values resolve to a 0-size audience and the ad
+     * fails at launch. For a tighter catchment use customLocations
+     * (lat/lng).
+     *
+     */
+    cities?: Array<{
+        key: string;
+        radius?: number;
+        distance_unit?: 'mile' | 'kilometer';
+    }>;
+    /**
+     * Region / state-level geo targeting. `key` is Meta's region
+     * ID (lookupable via GET /v1/ads/targeting/search?type=region).
+     *
+     */
+    regions?: Array<{
+        key: string;
+    }>;
+    /**
+     * ZIP / postal-code geo targeting. `key` is the platform's
+     * postal id resolved via /v1/ads/targeting/search.
+     *
+     */
+    zips?: Array<{
+        key: string;
+        name?: string;
+    }>;
+    /**
+     * DMA / metro-area geo targeting. `key` is Meta's metro id
+     * (e.g. `DMA:807`).
+     *
+     */
+    metros?: Array<{
+        key: string;
+        name?: string;
+    }>;
+    /**
+     * Point-radius geo (Meta `geo_locations.custom_locations`).
+     * Use for targeting a radius around a specific lat/long when
+     * no Meta city/region key fits. `distanceUnit` is required.
+     *
+     */
+    customLocations?: Array<{
+        latitude: number;
+        longitude: number;
+        radius: number;
+        distanceUnit: 'mile' | 'kilometer';
+        name?: string;
+        address?: string;
+    }>;
+    ageMin?: number;
+    ageMax?: number;
+    interests?: Array<{
+        id: string;
+        name?: string;
+    }>;
+    /**
+     * Custom audience ID to target.
+     */
+    audienceId?: string;
+    /**
+     * Manual ad placements on the shared ad set. Omit
+     * for automatic placements. When set, restricts delivery to the chosen surfaces,
+     * mapped onto the ad set's `targeting.{publisher_platforms, facebook_positions, instagram_positions,
+     * messenger_positions, audience_network_positions, threads_positions,
+     * whatsapp_positions, device_platforms}`. Enum membership is validated here; Meta
+     * additionally enforces co-selection rules and restricts which
+     * placements are eligible for click-to-WhatsApp ads, returning an actionable
+     * error which we surface.
+     *
+     */
+    placements?: {
+        /**
+         * Top-level platforms to deliver on. A position field below is only honoured when its parent platform is included here.
+         */
+        publisherPlatforms?: Array<('facebook' | 'instagram' | 'threads' | 'messenger' | 'audience_network' | 'whatsapp')>;
+        facebookPositions?: Array<('feed' | 'right_hand_column' | 'marketplace' | 'video_feeds' | 'story' | 'search' | 'instream_video' | 'facebook_reels' | 'facebook_reels_overlay' | 'profile_feed' | 'notification')>;
+        instagramPositions?: Array<('stream' | 'story' | 'explore' | 'explore_home' | 'reels' | 'profile_feed' | 'ig_search' | 'profile_reels')>;
+        messengerPositions?: Array<('messenger_home' | 'sponsored_messages' | 'story')>;
+        audienceNetworkPositions?: Array<('classic' | 'rewarded_video')>;
+        threadsPositions?: Array<('threads_stream')>;
+        whatsappPositions?: Array<('status')>;
+        /**
+         * Restrict by device. Omit to deliver on both mobile and desktop.
+         */
+        devicePlatforms?: Array<('mobile' | 'desktop')>;
+    };
+    /**
+     * Meta's Advantage+ audience expansion. `0` (default) keeps
+     * targeting strict; `1` lets Meta expand beyond the supplied
+     * targeting when its delivery system finds better matches.
+     * Always sent on CREATE (Meta requires it).
+     *
+     */
+    advantageAudience?: 0 | 1;
+    /**
+     * Defaults to `OUTCOME_ENGAGEMENT`. `OUTCOME_SALES` and `OUTCOME_LEADS` require
+     * additional account configuration (Dataset linked to the WABA
+     * for sales) and may be rejected by Meta if missing.
+     *
+     */
+    objective?: 'OUTCOME_ENGAGEMENT' | 'OUTCOME_SALES' | 'OUTCOME_LEADS';
+    /**
+     * Meta bid strategy applied to the shared ad set. Defaults to
+     * `LOWEST_COST_WITHOUT_CAP` (auto-bid) when omitted.
+     * `LOWEST_COST_WITH_BID_CAP` and `COST_CAP` require
+     * `bidAmount`. `LOWEST_COST_WITH_MIN_ROAS` requires
+     * `roasAverageFloor`. CTWA's `optimization_goal` is fixed to
+     * `CONVERSATIONS`, but the bid strategy is independent.
+     *
+     */
+    bidStrategy?: 'LOWEST_COST_WITHOUT_CAP' | 'LOWEST_COST_WITH_BID_CAP' | 'COST_CAP' | 'LOWEST_COST_WITH_MIN_ROAS';
+    /**
+     * Whole currency units (e.g. `5` = $5.00 on a USD account).
+     * Required when `bidStrategy` is `LOWEST_COST_WITH_BID_CAP`
+     * or `COST_CAP`; rejected otherwise.
+     *
+     */
+    bidAmount?: number;
+    /**
+     * Decimal ROAS multiplier (e.g. `2.0` = 2.0× ROAS floor).
+     * Required when `bidStrategy` is `LOWEST_COST_WITH_MIN_ROAS`;
+     * rejected otherwise. Meta enforces its own upper bound
+     * server-side.
+     *
+     */
+    roasAverageFloor?: number;
+    /**
+     * Legal entity that benefits from the ad. Required when targeting EU users
+     * (EU DSA, Article 26). Optional if the ad account has a default beneficiary:
+     * set it once via `PATCH /v1/ads/accounts` or in Meta Ads Manager, and Meta
+     * fills it in whenever the field is omitted.
+     *
+     */
+    dsaBeneficiary?: string;
+    /**
+     * Legal entity that pays for the ad. Can differ from `dsaBeneficiary`
+     * (for example, an agency paying for a client's ads). Same rules as
+     * `dsaBeneficiary`: required for EU targeting unless the ad account has
+     * a default payor.
+     *
+     */
+    dsaPayor?: string;
+};
+
+export type budgetType = 'daily' | 'lifetime';
+
+/**
+ * Meta's Advantage+ audience expansion. `0` (default) keeps
+ * targeting strict; `1` lets Meta expand beyond the supplied
+ * targeting when its delivery system finds better matches.
+ * Always sent on CREATE (Meta requires it).
+ *
+ */
+export type advantageAudience = 0 | 1;
+
+/**
+ * Defaults to `OUTCOME_ENGAGEMENT`. `OUTCOME_SALES` and `OUTCOME_LEADS` require
+ * additional account configuration (Dataset linked to the WABA
+ * for sales) and may be rejected by Meta if missing.
+ *
+ */
+export type objective = 'OUTCOME_ENGAGEMENT' | 'OUTCOME_SALES' | 'OUTCOME_LEADS';
+
+/**
+ * Meta bid strategy applied to the shared ad set. Defaults to
+ * `LOWEST_COST_WITHOUT_CAP` (auto-bid) when omitted.
+ * `LOWEST_COST_WITH_BID_CAP` and `COST_CAP` require
+ * `bidAmount`. `LOWEST_COST_WITH_MIN_ROAS` requires
+ * `roasAverageFloor`. CTWA's `optimization_goal` is fixed to
+ * `CONVERSATIONS`, but the bid strategy is independent.
+ *
+ */
+export type bidStrategy = 'LOWEST_COST_WITHOUT_CAP' | 'LOWEST_COST_WITH_BID_CAP' | 'COST_CAP' | 'LOWEST_COST_WITH_MIN_ROAS';
+
 /**
  * Response returned by `POST /v1/ads/ctwa` when the request used the
  * multi-creative shape (`creatives[]`). N persisted Ad documents share
@@ -23401,6 +23708,38 @@ export type DuplicateAdCampaignError = (unknown | {
     error?: string;
 });
 
+export type GetAdSetDetailsData = {
+    path: {
+        /**
+         * Meta ad set id (platformAdSetId).
+         */
+        adSetId: 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 GetAdSetDetailsResponse = ({
+    /**
+     * Raw Meta ad set; keys are the requested Graph fields.
+     */
+    adSet?: {
+        [key: string]: unknown;
+    };
+});
+
+export type GetAdSetDetailsError = (unknown | {
+    error?: string;
+});
+
 export type UpdateAdSetData = {
     body: {
         platform: 'facebook' | 'instagram' | 'tiktok' | 'linkedin' | 'pinterest' | 'google' | 'twitter';
@@ -23886,6 +24225,77 @@ export type GetCampaignAnalyticsError = (ErrorResponse | {
     error?: string;
 } | unknown);
 
+export type GenerateAdPreviewsData = {
+    body: {
+        /**
+         * Zernio SocialAccount id used to resolve the Meta token.
+         */
+        accountId: string;
+        /**
+         * Meta ad account id (act_<n>).
+         */
+        adAccountId: string;
+        /**
+         * Meta ad_format values, one preview per format. Defaults to [DESKTOP_FEED_STANDARD].
+         */
+        formats?: Array<(string)>;
+        /**
+         * Preview an existing ad-account creative by id. Mutually exclusive with creativeSpec.
+         */
+        existingCreativeId?: string;
+        /**
+         * Raw Meta creative spec forwarded verbatim to /generatepreviews. Mutually exclusive with existingCreativeId.
+         */
+        creativeSpec?: {
+            [key: string]: unknown;
+        };
+    };
+};
+
+export type GenerateAdPreviewsResponse = ({
+    previews?: Array<{
+        format?: string;
+        /**
+         * Meta's <iframe> snippet; null when Meta returned no preview for the format.
+         */
+        html?: (string) | null;
+    }>;
+});
+
+export type GenerateAdPreviewsError = (unknown | {
+    error?: string;
+});
+
+export type GetAdPreviewsData = {
+    path: {
+        /**
+         * Zernio ad id (24-char hex).
+         */
+        adId: string;
+    };
+    query?: {
+        /**
+         * Comma-separated Meta ad_format values (max 10), one preview per format. Defaults to DESKTOP_FEED_STANDARD.
+         */
+        formats?: string;
+    };
+};
+
+export type GetAdPreviewsResponse = ({
+    adId?: string;
+    previews?: Array<{
+        format?: string;
+        /**
+         * Meta's <iframe> snippet; null when Meta returned no preview for the format.
+         */
+        html?: (string) | null;
+    }>;
+});
+
+export type GetAdPreviewsError = (unknown | {
+    error?: string;
+});
+
 export type QueryAdInsightsData = {
     query: {
         /**
@@ -24330,40 +24740,179 @@ export type ListAdsBusinessCentersError = ({
     error?: string;
 } | unknown);
 
-export type ListAdAccountsData = {
+export type GetAdsActivityLogData = {
     query: {
         /**
-         * Social account ID
+         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
          */
         accountId: string;
         /**
-         * Filter response to a single platform ad account ID (e.g. `act_123` for Meta, advertiser_id for TikTok). Returns at most one item.
+         * Meta ad account id (act_<n>).
          */
-        adAccountId?: string;
+        adAccountId: string;
         /**
-         * Clamp the returned `accounts[]` length. Useful for typeahead pickers on agency tokens with hundreds of advertisers.
+         * Cursor from paging.after of the previous page.
          */
-        limit?: number;
-    };
-};
-
-export type ListAdAccountsResponse = ({
-    accounts?: Array<{
+        after?: string;
         /**
-         * Platform ad account ID (e.g. act_123)
+         * Rows per page
          */
-        id?: string;
-        name?: string;
-        currency?: string;
-        status?: string;
+        limit?: number;
         /**
-         * IANA timezone of the ad account (Meta only). Drives daily-budget reset and Insights day boundaries.
+         * Client-side filter to one Meta object id (campaign, ad set or ad).
          */
-        timezoneName?: string;
+        objectId?: string;
         /**
-         * Signed UTC offset in hours, reflecting current DST (Meta only).
+         * Start of range (YYYY-MM-DD).
          */
-        timezoneOffsetHoursUtc?: number;
+        since?: string;
+        /**
+         * End of range (YYYY-MM-DD).
+         */
+        until?: string;
+    };
+};
+
+export type GetAdsActivityLogResponse = ({
+    adAccountId?: string;
+    data?: Array<{
+        [key: string]: unknown;
+    }>;
+    paging?: {
+        /**
+         * Cursor for the next page; null when exhausted.
+         */
+        after?: (string) | null;
+    };
+});
+
+export type GetAdsActivityLogError = (unknown | {
+    error?: string;
+});
+
+export type ListAdStudiesData = {
+    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 ListAdStudiesResponse = ({
+    adAccountId?: string;
+    data?: Array<{
+        [key: string]: unknown;
+    }>;
+    paging?: {
+        /**
+         * Cursor for the next page; null when exhausted.
+         */
+        after?: (string) | null;
+    };
+});
+
+export type ListAdStudiesError = (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;
+        /**
+         * Meta funding source type code.
+         */
+        type?: number;
+    } | null;
+});
+
+export type GetAdAccountFinanceError = (unknown | {
+    error?: string;
+});
+
+export type ListAdAccountsData = {
+    query: {
+        /**
+         * Social account ID
+         */
+        accountId: string;
+        /**
+         * Filter response to a single platform ad account ID (e.g. `act_123` for Meta, advertiser_id for TikTok). Returns at most one item.
+         */
+        adAccountId?: string;
+        /**
+         * Clamp the returned `accounts[]` length. Useful for typeahead pickers on agency tokens with hundreds of advertisers.
+         */
+        limit?: number;
+    };
+};
+
+export type ListAdAccountsResponse = ({
+    accounts?: Array<{
+        /**
+         * Platform ad account ID (e.g. act_123)
+         */
+        id?: string;
+        name?: string;
+        currency?: string;
+        status?: string;
+        /**
+         * IANA timezone of the ad account (Meta only). Drives daily-budget reset and Insights day boundaries.
+         */
+        timezoneName?: string;
+        /**
+         * Signed UTC offset in hours, reflecting current DST (Meta only).
+         */
+        timezoneOffsetHoursUtc?: number;
         /**
          * Meta only. Minimum daily budget for the account, in the account currency's major units. This is the impressions-billed minimum; other billing events have higher minimums. Absent when the connected token cannot read it.
          */
@@ -24632,7 +25181,7 @@ export type BoostPostData = {
         /**
          * Meta only. Required for housing, employment, credit, or political ads.
          */
-        specialAdCategories?: Array<('HOUSING' | 'EMPLOYMENT' | 'CREDIT' | 'ISSUES_ELECTIONS_POLITICS')>;
+        specialAdCategories?: Array<('HOUSING' | 'EMPLOYMENT' | 'CREDIT' | 'FINANCIAL_PRODUCTS_SERVICES' | 'ISSUES_ELECTIONS_POLITICS' | 'ONLINE_GAMBLING_AND_GAMING')>;
         /**
          * TikTok-only. Custom destination URL for the Spark Ad. Without this, TikTok
          * Spark Ads have no clickable destination — required for traffic / conversion
@@ -24794,7 +25343,7 @@ export type CreateStandaloneAdData = {
         /**
          * Required on legacy + attach shapes for Meta. Honoured on TikTok (passes through to the Spark Ad creative's `call_to_action`) and on LinkedIn (the CTA button on the ad; defaults to LEARN_MORE when `linkUrl` is set). LinkedIn accepts: LEARN_MORE, SIGN_UP, DOWNLOAD, SUBSCRIBE, REGISTER, JOIN, ATTEND, REQUEST_DEMO, VIEW_QUOTE, APPLY, SEE_MORE, SHOP_NOW, BUY_NOW. Ignored by Google, Pinterest, and X/Twitter.
          */
-        callToAction?: 'LEARN_MORE' | 'SHOP_NOW' | 'SIGN_UP' | 'BOOK_TRAVEL' | 'CONTACT_US' | 'DOWNLOAD' | 'GET_OFFER' | 'GET_QUOTE' | 'SUBSCRIBE' | 'WATCH_MORE' | 'REGISTER' | 'JOIN' | 'ATTEND' | 'REQUEST_DEMO' | 'VIEW_QUOTE' | 'APPLY' | 'SEE_MORE' | 'BUY_NOW';
+        callToAction?: 'LEARN_MORE' | 'SHOP_NOW' | 'SIGN_UP' | 'BOOK_TRAVEL' | 'CONTACT_US' | 'DOWNLOAD' | 'GET_OFFER' | 'GET_QUOTE' | 'SUBSCRIBE' | 'WATCH_MORE' | 'ADD_TO_CART' | 'APPLY_NOW' | 'BOOK_NOW' | 'BUY_TICKETS' | 'DONATE' | 'DONATE_NOW' | 'GET_DIRECTIONS' | 'GET_SHOWTIMES' | 'LISTEN_NOW' | 'ORDER_NOW' | 'PLAY_GAME' | 'REQUEST_TIME' | 'SEE_MENU' | 'START_ORDER' | 'INSTALL_MOBILE_APP' | 'USE_APP' | 'REGISTER' | 'JOIN' | 'ATTEND' | 'REQUEST_DEMO' | 'VIEW_QUOTE' | 'APPLY' | 'SEE_MORE' | 'BUY_NOW';
         /**
          * Required on legacy + attach shapes (skip for multi-creative). On LinkedIn it's the ad's destination URL; required for `traffic` ads, optional for `engagement` / `awareness`. NOT required when `goal` is `lead_generation` (the ad opens a Lead Gen form instead of a destination). On LinkedIn, `imageUrl` + `linkUrl` publishes an ARTICLE-content creative; this is LinkedIn's article ad format, with the image as thumbnail and `longHeadline` as description.
          */
@@ -24863,7 +25412,7 @@ export type CreateStandaloneAdData = {
                 thumbnailUrl?: string;
             };
             linkUrl: string;
-            callToAction: 'LEARN_MORE' | 'SHOP_NOW' | 'SIGN_UP' | 'BOOK_TRAVEL' | 'CONTACT_US' | 'DOWNLOAD' | 'GET_OFFER' | 'GET_QUOTE' | 'SUBSCRIBE' | 'WATCH_MORE';
+            callToAction: 'LEARN_MORE' | 'SHOP_NOW' | 'SIGN_UP' | 'BOOK_TRAVEL' | 'CONTACT_US' | 'DOWNLOAD' | 'GET_OFFER' | 'GET_QUOTE' | 'SUBSCRIBE' | 'WATCH_MORE' | 'ADD_TO_CART' | 'APPLY_NOW' | 'BOOK_NOW' | 'BUY_TICKETS' | 'DONATE' | 'DONATE_NOW' | 'GET_DIRECTIONS' | 'GET_SHOWTIMES' | 'LISTEN_NOW' | 'ORDER_NOW' | 'PLAY_GAME' | 'REQUEST_TIME' | 'SEE_MENU' | 'START_ORDER' | 'INSTALL_MOBILE_APP' | 'USE_APP';
         }>;
         /**
          * Meta-only. When present, switches to the attach shape: adds
@@ -25085,7 +25634,7 @@ export type CreateStandaloneAdData = {
          * category disables income/zip targeting on Meta.
          *
          */
-        specialAdCategories?: Array<('HOUSING' | 'EMPLOYMENT' | 'CREDIT' | 'ISSUES_ELECTIONS_POLITICS')>;
+        specialAdCategories?: Array<('HOUSING' | 'EMPLOYMENT' | 'CREDIT' | 'FINANCIAL_PRODUCTS_SERVICES' | 'ISSUES_ELECTIONS_POLITICS' | 'ONLINE_GAMBLING_AND_GAMING')>;
         /**
          * Required for lifetime budgets
          */
@@ -25139,7 +25688,7 @@ export type CreateStandaloneAdData = {
             /**
              * CTA-button variations. Required.
              */
-            callToActionTypes?: Array<('LEARN_MORE' | 'SHOP_NOW' | 'SIGN_UP' | 'BOOK_TRAVEL' | 'CONTACT_US' | 'DOWNLOAD' | 'GET_OFFER' | 'GET_QUOTE' | 'SUBSCRIBE' | 'WATCH_MORE' | 'REGISTER' | 'JOIN' | 'ATTEND' | 'REQUEST_DEMO' | 'VIEW_QUOTE' | 'APPLY' | 'SEE_MORE' | 'BUY_NOW')>;
+            callToActionTypes?: Array<('LEARN_MORE' | 'SHOP_NOW' | 'SIGN_UP' | 'BOOK_TRAVEL' | 'CONTACT_US' | 'DOWNLOAD' | 'GET_OFFER' | 'GET_QUOTE' | 'SUBSCRIBE' | 'WATCH_MORE' | 'ADD_TO_CART' | 'APPLY_NOW' | 'BOOK_NOW' | 'BUY_TICKETS' | 'DONATE' | 'DONATE_NOW' | 'GET_DIRECTIONS' | 'GET_SHOWTIMES' | 'LISTEN_NOW' | 'ORDER_NOW' | 'PLAY_GAME' | 'REQUEST_TIME' | 'SEE_MENU' | 'START_ORDER' | 'INSTALL_MOBILE_APP' | 'USE_APP' | 'REGISTER' | 'JOIN' | 'ATTEND' | 'REQUEST_DEMO' | 'VIEW_QUOTE' | 'APPLY' | 'SEE_MORE' | 'BUY_NOW')>;
             /**
              * Asset-feed ad format. Defaults to SINGLE_IMAGE.
              */
@@ -25716,6 +26265,45 @@ export type CreateTestLeadError = ({
     error?: string;
 });
 
+export type UploadAdImageData = {
+    body: {
+        /**
+         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         */
+        accountId: string;
+        /**
+         * Meta ad account id (act_<n>).
+         */
+        adAccountId: string;
+        /**
+         * Raw base64 image bytes, or a full data URL (the data:image/...;base64, prefix is stripped).
+         */
+        imageBase64: string;
+        /**
+         * Optional filename shown in Meta's image library. Defaults to ad_image.jpg.
+         */
+        filename?: string;
+    };
+};
+
+export type UploadAdImageResponse = ({
+    adAccountId?: string;
+    image?: {
+        /**
+         * Meta image hash, reusable wherever image_hash is accepted.
+         */
+        hash?: string;
+        /**
+         * Meta-hosted image URL; usable as imageUrl on the create endpoints.
+         */
+        url?: string;
+    };
+});
+
+export type UploadAdImageError = (unknown | {
+    error?: string;
+});
+
 export type SearchAdInterestsData = {
     query: {
         /**
@@ -26363,8 +26951,12 @@ export type SendConversionsData = {
         testCode?: string;
         /**
          * Batch-level user consent. Required by Google for EEA/UK
-         * events under the Feb 2026 restrictions. Ignored by Meta
-         * and LinkedIn.
+         * events under the Feb 2026 restrictions. On Meta, any
+         * DENIED flag enables Limited Data Use on every event in
+         * the batch (data_processing_options ["LDU"] with
+         * geolocation, country 0 / state 0); GRANTED or absent
+         * consent sends events with Meta's default processing.
+         * Ignored by LinkedIn.
          *
          */
         consent?: {
@@ -27015,272 +27607,42 @@ export type SendWhatsAppConversionError = (unknown | {
     error?: string;
 });
 
+export type CreateMessagingAdData = {
+    body: (CtwaAdRequestBody & {
+    /**
+     * Where the conversation opens when the ad is tapped.
+     */
+    destination: 'whatsapp' | 'messenger' | 'instagram_direct';
+});
+};
+
+export type CreateMessagingAdResponse = (unknown);
+
+export type CreateMessagingAdError = (unknown | {
+    error?: string;
+});
+
+export type CreateCallAdData = {
+    body: (CtwaAdRequestBody & {
+    /**
+     * E.164 number the CALL_NOW CTA dials (e.g. +34600111222).
+     */
+    phoneNumber: string;
+    /**
+     * Website shown as the creative's link. Required: Meta rejects tel: as link_data.link; the phone number rides only the CTA.
+     */
+    linkUrl: string;
+});
+};
+
+export type CreateCallAdResponse = (unknown);
+
+export type CreateCallAdError = (unknown | {
+    error?: string;
+});
+
 export type CreateCtwaAdData = {
-    body: {
-        /**
-         * Facebook or Instagram SocialAccount ID.
-         */
-        accountId: string;
-        /**
-         * Meta ad account ID, e.g. `act_123456789`.
-         */
-        adAccountId: string;
-        /**
-         * Ad display name. Used to derive campaign / ad set names.
-         * On the multi-creative shape, each ad's Meta name gets a
-         * " #N" suffix (1-indexed) so Ads Manager shows them as a
-         * numbered batch.
-         *
-         */
-        name: string;
-        /**
-         * Single-creative shape only. Mutually exclusive with
-         * `creatives[]`.
-         *
-         */
-        headline?: string;
-        /**
-         * Primary text shown above the image / video. Single-creative
-         * shape only. Mutually exclusive with `creatives[]`.
-         *
-         */
-        body?: string;
-        /**
-         * Image asset for single-creative shape. Mutually exclusive
-         * with `video` and with `creatives[]`. Required on the
-         * single-creative shape if `video` is not supplied.
-         *
-         */
-        imageUrl?: string;
-        /**
-         * Video creative for single-creative shape. Mutually
-         * exclusive with `imageUrl` and with `creatives[]`. Required
-         * on the single-creative shape if `imageUrl` is not supplied.
-         *
-         */
-        video?: {
-            url: string;
-            /**
-             * Required by Meta for every video creative. Used as the
-             * ad thumbnail.
-             *
-             */
-            thumbnailUrl: string;
-        };
-        /**
-         * Multi-creative shape: N CTWA ads under one campaign + one
-         * ad set, sharing budget and targeting. Mutually exclusive
-         * with the top-level single-creative fields (`headline` /
-         * `body` / `imageUrl` / `video`). Each entry must supply its
-         * own headline, body, and exactly one of `imageUrl` /
-         * `video`.
-         *
-         */
-        creatives?: Array<{
-            headline: string;
-            /**
-             * Primary text shown above the image / video.
-             */
-            body: string;
-            /**
-             * Image asset. Mutually exclusive with this entry's
-             * `video`. Required if `video` is not supplied.
-             *
-             */
-            imageUrl?: string;
-            /**
-             * Video creative. Mutually exclusive with this entry's
-             * `imageUrl`. Required if `imageUrl` is not supplied.
-             *
-             */
-            video?: {
-                url: string;
-                /**
-                 * Required by Meta for every video creative. Used
-                 * as the ad thumbnail.
-                 *
-                 */
-                thumbnailUrl: string;
-            };
-        }>;
-        /**
-         * Budget amount in the ad account's currency major units
-         * (e.g. dollars for USD, not cents). Must be > 0.
-         *
-         */
-        budgetAmount: number;
-        budgetType: 'daily' | 'lifetime';
-        /**
-         * ISO 4217 currency code matching the ad account's currency
-         * (e.g. `USD`). Optional; Meta infers from the ad account
-         * when omitted.
-         *
-         */
-        currency?: string;
-        /**
-         * ISO 8601 datetime. Required when `budgetType` is `lifetime`.
-         *
-         */
-        endDate?: string;
-        /**
-         * ISO 3166-1 alpha-2 country codes. Defaults to `["US"]` only
-         * when no other geo (`cities`, `regions`, `zips`, `metros`,
-         * `customLocations`) is supplied.
-         *
-         */
-        countries?: Array<(string)>;
-        /**
-         * City-level geo targeting for local CTWA campaigns (e.g.
-         * 25km radius around Milan). Each entry maps to Meta's
-         * TargetingGeoLocationCity. `key` is Meta's city ID
-         * (lookupable via GET /v1/ads/targeting/search). `radius`
-         * and `distance_unit` are coupled: set both or neither.
-         * Meta enforces a minimum city radius (~17 km / 10 mi);
-         * smaller values resolve to a 0-size audience and the ad
-         * fails at launch. For a tighter catchment use customLocations
-         * (lat/lng).
-         *
-         */
-        cities?: Array<{
-            key: string;
-            radius?: number;
-            distance_unit?: 'mile' | 'kilometer';
-        }>;
-        /**
-         * Region / state-level geo targeting. `key` is Meta's region
-         * ID (lookupable via GET /v1/ads/targeting/search?type=region).
-         *
-         */
-        regions?: Array<{
-            key: string;
-        }>;
-        /**
-         * ZIP / postal-code geo targeting. `key` is the platform's
-         * postal id resolved via /v1/ads/targeting/search.
-         *
-         */
-        zips?: Array<{
-            key: string;
-            name?: string;
-        }>;
-        /**
-         * DMA / metro-area geo targeting. `key` is Meta's metro id
-         * (e.g. `DMA:807`).
-         *
-         */
-        metros?: Array<{
-            key: string;
-            name?: string;
-        }>;
-        /**
-         * Point-radius geo (Meta `geo_locations.custom_locations`).
-         * Use for targeting a radius around a specific lat/long when
-         * no Meta city/region key fits. `distanceUnit` is required.
-         *
-         */
-        customLocations?: Array<{
-            latitude: number;
-            longitude: number;
-            radius: number;
-            distanceUnit: 'mile' | 'kilometer';
-            name?: string;
-            address?: string;
-        }>;
-        ageMin?: number;
-        ageMax?: number;
-        interests?: Array<{
-            id: string;
-            name?: string;
-        }>;
-        /**
-         * Custom audience ID to target.
-         */
-        audienceId?: string;
-        /**
-         * Manual ad placements on the shared ad set. Omit
-         * for automatic placements. When set, restricts delivery to the chosen surfaces,
-         * mapped onto the ad set's `targeting.{publisher_platforms, facebook_positions, instagram_positions,
-         * messenger_positions, audience_network_positions, threads_positions,
-         * whatsapp_positions, device_platforms}`. Enum membership is validated here; Meta
-         * additionally enforces co-selection rules and restricts which
-         * placements are eligible for click-to-WhatsApp ads, returning an actionable
-         * error which we surface.
-         *
-         */
-        placements?: {
-            /**
-             * Top-level platforms to deliver on. A position field below is only honoured when its parent platform is included here.
-             */
-            publisherPlatforms?: Array<('facebook' | 'instagram' | 'threads' | 'messenger' | 'audience_network' | 'whatsapp')>;
-            facebookPositions?: Array<('feed' | 'right_hand_column' | 'marketplace' | 'video_feeds' | 'story' | 'search' | 'instream_video' | 'facebook_reels' | 'facebook_reels_overlay' | 'profile_feed' | 'notification')>;
-            instagramPositions?: Array<('stream' | 'story' | 'explore' | 'explore_home' | 'reels' | 'profile_feed' | 'ig_search' | 'profile_reels')>;
-            messengerPositions?: Array<('messenger_home' | 'sponsored_messages' | 'story')>;
-            audienceNetworkPositions?: Array<('classic' | 'rewarded_video')>;
-            threadsPositions?: Array<('threads_stream')>;
-            whatsappPositions?: Array<('status')>;
-            /**
-             * Restrict by device. Omit to deliver on both mobile and desktop.
-             */
-            devicePlatforms?: Array<('mobile' | 'desktop')>;
-        };
-        /**
-         * Meta's Advantage+ audience expansion. `0` (default) keeps
-         * targeting strict; `1` lets Meta expand beyond the supplied
-         * targeting when its delivery system finds better matches.
-         * Always sent on CREATE (Meta requires it).
-         *
-         */
-        advantageAudience?: 0 | 1;
-        /**
-         * Defaults to `OUTCOME_ENGAGEMENT` (the broadly-supported CTWA
-         * objective). `OUTCOME_SALES` and `OUTCOME_LEADS` require
-         * additional account configuration (Dataset linked to the WABA
-         * for sales) and may be rejected by Meta if missing.
-         *
-         */
-        objective?: 'OUTCOME_ENGAGEMENT' | 'OUTCOME_SALES' | 'OUTCOME_LEADS';
-        /**
-         * Meta bid strategy applied to the shared ad set. Defaults to
-         * `LOWEST_COST_WITHOUT_CAP` (auto-bid) when omitted.
-         * `LOWEST_COST_WITH_BID_CAP` and `COST_CAP` require
-         * `bidAmount`. `LOWEST_COST_WITH_MIN_ROAS` requires
-         * `roasAverageFloor`. CTWA's `optimization_goal` is fixed to
-         * `CONVERSATIONS`, but the bid strategy is independent.
-         *
-         */
-        bidStrategy?: 'LOWEST_COST_WITHOUT_CAP' | 'LOWEST_COST_WITH_BID_CAP' | 'COST_CAP' | 'LOWEST_COST_WITH_MIN_ROAS';
-        /**
-         * Whole currency units (e.g. `5` = $5.00 on a USD account).
-         * Required when `bidStrategy` is `LOWEST_COST_WITH_BID_CAP`
-         * or `COST_CAP`; rejected otherwise.
-         *
-         */
-        bidAmount?: number;
-        /**
-         * Decimal ROAS multiplier (e.g. `2.0` = 2.0× ROAS floor).
-         * Required when `bidStrategy` is `LOWEST_COST_WITH_MIN_ROAS`;
-         * rejected otherwise. Meta enforces its own upper bound
-         * server-side.
-         *
-         */
-        roasAverageFloor?: number;
-        /**
-         * Legal entity that benefits from the ad. Required when targeting EU users
-         * (EU DSA, Article 26). Optional if the ad account has a default beneficiary:
-         * set it once via `PATCH /v1/ads/accounts` or in Meta Ads Manager, and Meta
-         * fills it in whenever the field is omitted.
-         *
-         */
-        dsaBeneficiary?: string;
-        /**
-         * Legal entity that pays for the ad. Can differ from `dsaBeneficiary`
-         * (for example, an agency paying for a client's ads). Same rules as
-         * `dsaBeneficiary`: required for EU targeting unless the ad account has
-         * a default payor.
-         *
-         */
-        dsaPayor?: string;
-    };
+    body: CtwaAdRequestBody;
 };
 
 export type CreateCtwaAdResponse = ((CtwaSingleResponse | CtwaMultiResponse));