@getlatedev/node 0.2.394 → 0.2.396

package/src/generated/types.gen.ts

@@ -4853,6 +4853,33 @@ export type UsersListResponse = {
     users?: Array<User>;
 };
 
+/**
+ * A managed OTP verification. The code itself is never returned or stored (hash only).
+ */
+export type Verification = {
+    id?: string;
+    status?: 'pending' | 'approved' | 'expired' | 'max_attempts_reached' | 'canceled' | 'delivery_failed';
+    channel?: 'sms';
+    to?: string;
+    expiresAt?: string;
+    attempts?: number;
+    maxAttempts?: number;
+    /**
+     * Accepted deliveries (initial send + resends); each bills one verification fee.
+     */
+    sendCount?: number;
+    lastSentAt?: (string) | null;
+    createdAt?: string;
+    /**
+     * Present on create responses: true when an active verification was resent instead of created.
+     */
+    resend?: boolean;
+};
+
+export type status9 = 'pending' | 'approved' | 'expired' | 'max_attempts_reached' | 'canceled' | 'delivery_failed';
+
+export type channel2 = 'sms';
+
 /**
  * Individual webhook configuration for receiving real-time notifications
  */
@@ -4876,7 +4903,7 @@ export type Webhook = {
     /**
      * Events subscribed to
      */
-    events?: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'post.platform.published' | 'post.platform.failed' | 'post.tiktok.url_resolved' | 'post.external.created' | 'post.external.updated' | 'post.external.deleted' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'conversation.started' | 'call.received' | 'call.ended' | 'call.failed' | 'call.permission_request' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'comment.received' | 'review.new' | 'review.updated' | 'lead.received' | 'ad.status_changed' | 'whatsapp.template.status_updated' | 'whatsapp.automatic_event' | 'whatsapp.number.activated' | 'whatsapp.number.declined' | 'whatsapp.number.action_required' | 'whatsapp.number.verification_required' | 'whatsapp.number.suspended' | 'whatsapp.number.reactivated' | 'whatsapp.number.released' | 'whatsapp.number.kyc_submitted')>;
+    events?: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'post.platform.published' | 'post.platform.failed' | 'post.tiktok.url_resolved' | 'post.external.created' | 'post.external.updated' | 'post.external.deleted' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'conversation.started' | 'call.received' | 'call.ended' | 'call.failed' | 'call.permission_request' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'comment.received' | 'review.new' | 'review.updated' | 'lead.received' | 'ad.status_changed' | 'whatsapp.template.status_updated' | 'whatsapp.automatic_event' | 'whatsapp.number.activated' | 'whatsapp.number.declined' | 'whatsapp.number.action_required' | 'whatsapp.number.verification_required' | 'whatsapp.number.suspended' | 'whatsapp.number.reactivated' | 'whatsapp.number.released' | 'whatsapp.number.kyc_submitted' | 'verification.approved' | 'verification.failed')>;
     /**
      * Whether webhook delivery is enabled
      */
@@ -4964,7 +4991,7 @@ export type WebhookLog = {
 /**
  * Delivery outcome
  */
-export type status9 = 'success' | 'failed';
+export type status10 = 'success' | 'failed';
 
 /**
  * Webhook payload for `account.ads.initial_sync_completed` events.
@@ -5073,7 +5100,7 @@ export type event = 'account.ads.initial_sync_completed';
 /**
  * Overall outcome of the initial sync.
  */
-export type status10 = 'success' | 'failure';
+export type status11 = 'success' | 'failure';
 
 /**
  * Stable category for UX branching. New values may be added; existing ones are
@@ -6509,7 +6536,7 @@ export type platform10 = 'whatsapp';
  * request before the template is actually removed.
  *
  */
-export type status11 = 'APPROVED' | 'REJECTED' | 'PENDING' | 'PAUSED' | 'DISABLED' | 'IN_APPEAL' | 'PENDING_DELETION';
+export type status12 = 'APPROVED' | 'REJECTED' | 'PENDING' | 'PAUSED' | 'DISABLED' | 'IN_APPEAL' | 'PENDING_DELETION';
 
 export type WhatsAppBodyComponent = {
     type: 'body';
@@ -6610,7 +6637,7 @@ export type WhatsAppSandboxSession = {
  * list responses.
  *
  */
-export type status12 = 'pending' | 'active';
+export type status13 = 'pending' | 'active';
 
 export type WhatsAppTemplateButton = {
     type: 'quick_reply' | 'url' | 'phone_number' | 'otp' | 'copy_code' | 'flow' | 'mpm' | 'catalog';
@@ -6729,7 +6756,7 @@ export type WorkflowExecutionEvent = {
 
 export type action2 = 'execution_started' | 'execution_completed' | 'execution_exited' | 'execution_paused' | 'execution_resumed' | 'node_started' | 'node_completed' | 'node_failed' | 'node_skipped';
 
-export type status13 = 'success' | 'failed' | 'pending';
+export type status14 = 'success' | 'failed' | 'pending';
 
 /**
  * A node in a workflow graph. `config` shape depends on `type`.
@@ -14146,7 +14173,7 @@ export type CreateWebhookSettingsData = {
         /**
          * Events to subscribe to (at least one required)
          */
-        events: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'post.platform.published' | 'post.platform.failed' | 'post.tiktok.url_resolved' | 'post.external.created' | 'post.external.updated' | 'post.external.deleted' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'conversation.started' | 'call.received' | 'call.ended' | 'call.failed' | 'call.permission_request' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'comment.received' | 'review.new' | 'review.updated' | 'lead.received' | 'ad.status_changed' | 'whatsapp.template.status_updated' | 'whatsapp.automatic_event' | 'whatsapp.number.activated' | 'whatsapp.number.declined' | 'whatsapp.number.action_required' | 'whatsapp.number.verification_required' | 'whatsapp.number.suspended' | 'whatsapp.number.reactivated' | 'whatsapp.number.released' | 'whatsapp.number.kyc_submitted')>;
+        events: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'post.platform.published' | 'post.platform.failed' | 'post.tiktok.url_resolved' | 'post.external.created' | 'post.external.updated' | 'post.external.deleted' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'conversation.started' | 'call.received' | 'call.ended' | 'call.failed' | 'call.permission_request' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'comment.received' | 'review.new' | 'review.updated' | 'lead.received' | 'ad.status_changed' | 'whatsapp.template.status_updated' | 'whatsapp.automatic_event' | 'whatsapp.number.activated' | 'whatsapp.number.declined' | 'whatsapp.number.action_required' | 'whatsapp.number.verification_required' | 'whatsapp.number.suspended' | 'whatsapp.number.reactivated' | 'whatsapp.number.released' | 'whatsapp.number.kyc_submitted' | 'verification.approved' | 'verification.failed')>;
         /**
          * Enable or disable webhook delivery. Defaults to `true` when omitted.
          */
@@ -14190,7 +14217,7 @@ export type UpdateWebhookSettingsData = {
         /**
          * Events to subscribe to. Must contain at least one event if provided.
          */
-        events?: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'post.platform.published' | 'post.platform.failed' | 'post.tiktok.url_resolved' | 'post.external.created' | 'post.external.updated' | 'post.external.deleted' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'conversation.started' | 'call.received' | 'call.ended' | 'call.failed' | 'call.permission_request' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'comment.received' | 'review.new' | 'review.updated' | 'lead.received' | 'ad.status_changed' | 'whatsapp.template.status_updated' | 'whatsapp.automatic_event' | 'whatsapp.number.activated' | 'whatsapp.number.declined' | 'whatsapp.number.action_required' | 'whatsapp.number.verification_required' | 'whatsapp.number.suspended' | 'whatsapp.number.reactivated' | 'whatsapp.number.released' | 'whatsapp.number.kyc_submitted')>;
+        events?: Array<('post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled' | 'post.platform.published' | 'post.platform.failed' | 'post.tiktok.url_resolved' | 'post.external.created' | 'post.external.updated' | 'post.external.deleted' | 'account.connected' | 'account.disconnected' | 'account.ads.initial_sync_completed' | 'message.received' | 'conversation.started' | 'call.received' | 'call.ended' | 'call.failed' | 'call.permission_request' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'comment.received' | 'review.new' | 'review.updated' | 'lead.received' | 'ad.status_changed' | 'whatsapp.template.status_updated' | 'whatsapp.automatic_event' | 'whatsapp.number.activated' | 'whatsapp.number.declined' | 'whatsapp.number.action_required' | 'whatsapp.number.verification_required' | 'whatsapp.number.suspended' | 'whatsapp.number.reactivated' | 'whatsapp.number.released' | 'whatsapp.number.kyc_submitted' | 'verification.approved' | 'verification.failed')>;
         /**
          * Enable or disable webhook delivery
          */
@@ -23758,6 +23785,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';
@@ -23949,6 +24018,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: {
         /**
@@ -25180,6 +25332,271 @@ export type ListAdStudiesError = (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;
+    };
+};
+
+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: {
         /**
@@ -26660,6 +27077,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: {
         /**
@@ -28215,4 +28674,62 @@ export type GetTrackingTagStatsResponse = ({
 
 export type GetTrackingTagStatsError = (unknown | {
     error?: string;
-});
+});
+
+export type CreateVerificationData = {
+    body: {
+        /**
+         * SMS-only for now.
+         */
+        channel: 'sms';
+        /**
+         * E.164 phone number.
+         */
+        to: string;
+        /**
+         * The SMS-enabled number on your account to send from. Defaults to your only SMS number.
+         */
+        from?: string;
+        /**
+         * Your app or business name, rendered in the message. Defaults to your account name. Letters, numbers, and basic punctuation only.
+         */
+        brandName?: string;
+        codeLength?: number;
+        ttlMinutes?: number;
+    };
+};
+
+export type CreateVerificationResponse = (Verification);
+
+export type CreateVerificationError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type GetVerificationData = {
+    path: {
+        verificationId: string;
+    };
+};
+
+export type GetVerificationResponse = (Verification);
+
+export type GetVerificationError = (ErrorResponse | {
+    error?: string;
+} | unknown);
+
+export type CheckVerificationData = {
+    body: {
+        code: string;
+    };
+    path: {
+        verificationId: string;
+    };
+};
+
+export type CheckVerificationResponse = ((Verification & {
+    valid?: boolean;
+}));
+
+export type CheckVerificationError = (ErrorResponse | {
+    error?: string;
+} | unknown);