@getlatedev/node 0.2.335 → 0.2.337

package/dist/index.d.mts

@@ -4859,7 +4859,7 @@ 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' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'comment.received' | 'review.new' | 'review.updated' | 'ad.status_changed' | 'whatsapp.template.status_updated' | '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')>;
     /**
      * Whether webhook delivery is enabled
      */
@@ -13408,7 +13408,7 @@ 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' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'comment.received' | 'review.new' | 'review.updated' | 'ad.status_changed' | 'whatsapp.template.status_updated' | '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')>;
         /**
          * Enable or disable webhook delivery. Defaults to `true` when omitted.
          */
@@ -13449,7 +13449,7 @@ 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' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'comment.received' | 'review.new' | 'review.updated' | 'ad.status_changed' | 'whatsapp.template.status_updated' | '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')>;
         /**
          * Enable or disable webhook delivery
          */
@@ -16386,7 +16386,7 @@ type ListWhatsAppCallsError = ({
 });
 type GetWhatsAppCallData = {
     path: {
-        callId: string;
+        id: string;
     };
     query: {
         accountId: string;
@@ -16402,7 +16402,7 @@ type GetWhatsAppCallError = ({
 } | unknown);
 type GetWhatsAppCallRecordingData = {
     path: {
-        callId: string;
+        id: string;
     };
     query: {
         accountId: string;
@@ -16886,9 +16886,16 @@ type StartSmsRegistrationData = {
          */
         campaign?: {
             usecase: string;
+            /**
+             * The concrete kinds of messages a MIXED campaign sends (the carrier
+             * registry requires 2-5, and reviewers match them against the sample
+             * messages). Omitted: a default pair is applied for MIXED.
+             *
+             */
+            subUsecases?: Array<('2FA' | 'ACCOUNT_NOTIFICATION' | 'CUSTOMER_CARE' | 'DELIVERY_NOTIFICATION' | 'FRAUD_ALERT' | 'HIGHER_EDUCATION' | 'MARKETING' | 'POLLING_VOTING' | 'PUBLIC_SERVICE_ANNOUNCEMENT' | 'SECURITY_ALERT')>;
             description: string;
             /**
-             * How a recipient ends up receiving your messages (the opt-in flow).
+             * How a recipient ends up receiving your messages (the opt-in flow). Include a link to the page or form where they opt in — carrier reviewers reject campaigns whose consent they can't verify.
              */
             messageFlow: string;
             sample1: string;
@@ -17019,6 +17026,17 @@ type GetSmsRegistrationResponse = ({
     declineReason?: (string) | null;
     phoneNumbers?: Array<(string)>;
     awaitingOtp?: boolean;
+    /**
+     * The submitted campaign content, present only for rejected
+     * registrations with a campaign. Edit and resubmit it via the
+     * appeal endpoint's optional content fields.
+     *
+     */
+    campaignContent?: {
+        messageFlow?: string;
+        sample1?: string;
+        sample2?: string;
+    };
 });
 type GetSmsRegistrationError = ({
     error?: string;
@@ -17039,7 +17057,16 @@ type VerifySmsRegistrationOtpError = ({
 } | unknown);
 type AppealSmsRegistrationData = {
     body: {
+        /**
+         * Goes verbatim to the carrier reviewer — address the decline reason directly.
+         */
         appealReason: string;
+        /**
+         * Corrected opt-in flow; include a link to the opt-in page/form.
+         */
+        messageFlow?: string;
+        sample1?: string;
+        sample2?: string;
     };
     path: {
         id: string;

package/dist/index.d.ts

@@ -4859,7 +4859,7 @@ 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' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'comment.received' | 'review.new' | 'review.updated' | 'ad.status_changed' | 'whatsapp.template.status_updated' | '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')>;
     /**
      * Whether webhook delivery is enabled
      */
@@ -13408,7 +13408,7 @@ 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' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'comment.received' | 'review.new' | 'review.updated' | 'ad.status_changed' | 'whatsapp.template.status_updated' | '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')>;
         /**
          * Enable or disable webhook delivery. Defaults to `true` when omitted.
          */
@@ -13449,7 +13449,7 @@ 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' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'comment.received' | 'review.new' | 'review.updated' | 'ad.status_changed' | 'whatsapp.template.status_updated' | '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')>;
         /**
          * Enable or disable webhook delivery
          */
@@ -16386,7 +16386,7 @@ type ListWhatsAppCallsError = ({
 });
 type GetWhatsAppCallData = {
     path: {
-        callId: string;
+        id: string;
     };
     query: {
         accountId: string;
@@ -16402,7 +16402,7 @@ type GetWhatsAppCallError = ({
 } | unknown);
 type GetWhatsAppCallRecordingData = {
     path: {
-        callId: string;
+        id: string;
     };
     query: {
         accountId: string;
@@ -16886,9 +16886,16 @@ type StartSmsRegistrationData = {
          */
         campaign?: {
             usecase: string;
+            /**
+             * The concrete kinds of messages a MIXED campaign sends (the carrier
+             * registry requires 2-5, and reviewers match them against the sample
+             * messages). Omitted: a default pair is applied for MIXED.
+             *
+             */
+            subUsecases?: Array<('2FA' | 'ACCOUNT_NOTIFICATION' | 'CUSTOMER_CARE' | 'DELIVERY_NOTIFICATION' | 'FRAUD_ALERT' | 'HIGHER_EDUCATION' | 'MARKETING' | 'POLLING_VOTING' | 'PUBLIC_SERVICE_ANNOUNCEMENT' | 'SECURITY_ALERT')>;
             description: string;
             /**
-             * How a recipient ends up receiving your messages (the opt-in flow).
+             * How a recipient ends up receiving your messages (the opt-in flow). Include a link to the page or form where they opt in — carrier reviewers reject campaigns whose consent they can't verify.
              */
             messageFlow: string;
             sample1: string;
@@ -17019,6 +17026,17 @@ type GetSmsRegistrationResponse = ({
     declineReason?: (string) | null;
     phoneNumbers?: Array<(string)>;
     awaitingOtp?: boolean;
+    /**
+     * The submitted campaign content, present only for rejected
+     * registrations with a campaign. Edit and resubmit it via the
+     * appeal endpoint's optional content fields.
+     *
+     */
+    campaignContent?: {
+        messageFlow?: string;
+        sample1?: string;
+        sample2?: string;
+    };
 });
 type GetSmsRegistrationError = ({
     error?: string;
@@ -17039,7 +17057,16 @@ type VerifySmsRegistrationOtpError = ({
 } | unknown);
 type AppealSmsRegistrationData = {
     body: {
+        /**
+         * Goes verbatim to the carrier reviewer — address the decline reason directly.
+         */
         appealReason: string;
+        /**
+         * Corrected opt-in flow; include a link to the opt-in page/form.
+         */
+        messageFlow?: string;
+        sample1?: string;
+        sample2?: string;
     };
     path: {
         id: string;

package/dist/index.js

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@getlatedev/node",
-  version: "0.2.335",
+  version: "0.2.337",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",
@@ -1777,13 +1777,13 @@ var listWhatsAppCalls = (options) => {
 var getWhatsAppCall = (options) => {
   return (options?.client ?? client).get({
     ...options,
-    url: "/v1/whatsapp/calls/{callId}"
+    url: "/v1/whatsapp/calls/{id}"
   });
 };
 var getWhatsAppCallRecording = (options) => {
   return (options?.client ?? client).get({
     ...options,
-    url: "/v1/whatsapp/calls/{callId}/recording"
+    url: "/v1/whatsapp/calls/{id}/recording"
   });
 };
 var getWhatsAppCallEstimate = (options) => {

package/dist/index.mjs

@@ -5,7 +5,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
 // package.json
 var package_default = {
   name: "@getlatedev/node",
-  version: "0.2.335",
+  version: "0.2.337",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",
@@ -1746,13 +1746,13 @@ var listWhatsAppCalls = (options) => {
 var getWhatsAppCall = (options) => {
   return (options?.client ?? client).get({
     ...options,
-    url: "/v1/whatsapp/calls/{callId}"
+    url: "/v1/whatsapp/calls/{id}"
   });
 };
 var getWhatsAppCallRecording = (options) => {
   return (options?.client ?? client).get({
     ...options,
-    url: "/v1/whatsapp/calls/{callId}/recording"
+    url: "/v1/whatsapp/calls/{id}/recording"
   });
 };
 var getWhatsAppCallEstimate = (options) => {

package/package.json

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

package/src/generated/sdk.gen.ts

@@ -3567,7 +3567,7 @@ export const listWhatsAppCalls = <ThrowOnError extends boolean = false>(options:
 export const getWhatsAppCall = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetWhatsAppCallData, ThrowOnError>) => {
     return (options?.client ?? client).get<GetWhatsAppCallResponse, GetWhatsAppCallError, ThrowOnError>({
         ...options,
-        url: '/v1/whatsapp/calls/{callId}'
+        url: '/v1/whatsapp/calls/{id}'
     });
 };
 
@@ -3584,7 +3584,7 @@ export const getWhatsAppCall = <ThrowOnError extends boolean = false>(options: O
 export const getWhatsAppCallRecording = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetWhatsAppCallRecordingData, ThrowOnError>) => {
     return (options?.client ?? client).get<GetWhatsAppCallRecordingResponse, GetWhatsAppCallRecordingError, ThrowOnError>({
         ...options,
-        url: '/v1/whatsapp/calls/{callId}/recording'
+        url: '/v1/whatsapp/calls/{id}/recording'
     });
 };
 
@@ -3928,6 +3928,13 @@ export const verifySmsRegistrationOtp = <ThrowOnError extends boolean = false>(o
  * brand-level rejection should be fixed and re-verified instead. On
  * success the registration returns to `pending`.
  *
+ * Content rejections (e.g. an opt-in flow without a verifiable form link,
+ * or unrealistic samples) should be FIXED in the same call: pass the
+ * corrected `messageFlow` / `sample1` / `sample2` and the campaign is
+ * updated before the appeal is filed, so the reviewer sees the new
+ * content. The current content is on `GET /v1/sms/registrations/{id}`
+ * (`campaignContent`).
+ *
  */
 export const appealSmsRegistration = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<AppealSmsRegistrationData, ThrowOnError>) => {
     return (options?.client ?? client).post<AppealSmsRegistrationResponse, AppealSmsRegistrationError, ThrowOnError>({
@@ -4275,11 +4282,14 @@ export const releasePhoneNumber = <ThrowOnError extends boolean = false>(options
 
 /**
  * Purchase phone number
- * Initiate purchasing a phone number. Payment-first flow: the user does not pick
- * a specific number. The system either creates a Stripe Checkout Session (first number)
- * or increments the existing subscription quantity and provisions inline (subsequent numbers).
+ * Payment-first: you do not pick a specific number, the system provisions one and
+ * auto-assigns it. With usage-based billing active and a payment method on file, the
+ * number provisions inline and bills per month on your usage-based invoice (there is
+ * no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`;
+ * a regulated country returns `202` with `status: "kyc_required"` and a `kycUrl`.
  *
- * Requires a paid plan. The maximum number of phone numbers is determined by the user's plan.
+ * Requires usage-based billing (the Usage plan). The maximum number of phone numbers
+ * is determined by the user's plan.
  *
  */
 export const purchasePhoneNumber = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<PurchasePhoneNumberData, ThrowOnError>) => {
@@ -4366,11 +4376,14 @@ export const getWhatsAppPhoneNumbers = <ThrowOnError extends boolean = false>(op
  * Deprecated alias of `/v1/phone-numbers/purchase`; same contract. New
  * integrations should use that path.
  *
- * Initiate purchasing a WhatsApp phone number. Payment-first flow: the user does not pick
- * a specific number. The system either creates a Stripe Checkout Session (first number)
- * or increments the existing subscription quantity and provisions inline (subsequent numbers).
+ * Payment-first: you do not pick a specific number, the system provisions one and
+ * auto-assigns it. With usage-based billing active and a payment method on file, the
+ * number provisions inline and bills per month on your usage-based invoice (there is
+ * no checkout redirect). No payment method on file returns `402 PAYMENT_REQUIRED`;
+ * a regulated country returns `202` with `status: "kyc_required"` and a `kycUrl`.
  *
- * Requires a paid plan. The maximum number of phone numbers is determined by the user's plan.
+ * Requires usage-based billing (the Usage plan). The maximum number of phone numbers
+ * is determined by the user's plan.
  *
  */
 export const purchaseWhatsAppPhoneNumber = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<PurchaseWhatsAppPhoneNumberData, ThrowOnError>) => {

package/src/generated/types.gen.ts

@@ -4164,7 +4164,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' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'comment.received' | 'review.new' | 'review.updated' | 'ad.status_changed' | 'whatsapp.template.status_updated' | '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')>;
     /**
      * Whether webhook delivery is enabled
      */
@@ -13307,7 +13307,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' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'comment.received' | 'review.new' | 'review.updated' | 'ad.status_changed' | 'whatsapp.template.status_updated' | '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')>;
         /**
          * Enable or disable webhook delivery. Defaults to `true` when omitted.
          */
@@ -13351,7 +13351,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' | 'message.sent' | 'message.edited' | 'message.deleted' | 'message.delivered' | 'message.read' | 'message.failed' | 'reaction.received' | 'comment.received' | 'review.new' | 'review.updated' | 'ad.status_changed' | 'whatsapp.template.status_updated' | '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')>;
         /**
          * Enable or disable webhook delivery
          */
@@ -16474,7 +16474,7 @@ export type ListWhatsAppCallsError = ({
 
 export type GetWhatsAppCallData = {
     path: {
-        callId: string;
+        id: string;
     };
     query: {
         accountId: string;
@@ -16493,7 +16493,7 @@ export type GetWhatsAppCallError = ({
 
 export type GetWhatsAppCallRecordingData = {
     path: {
-        callId: string;
+        id: string;
     };
     query: {
         accountId: string;
@@ -17027,9 +17027,16 @@ export type StartSmsRegistrationData = {
          */
         campaign?: {
             usecase: string;
+            /**
+             * The concrete kinds of messages a MIXED campaign sends (the carrier
+             * registry requires 2-5, and reviewers match them against the sample
+             * messages). Omitted: a default pair is applied for MIXED.
+             *
+             */
+            subUsecases?: Array<('2FA' | 'ACCOUNT_NOTIFICATION' | 'CUSTOMER_CARE' | 'DELIVERY_NOTIFICATION' | 'FRAUD_ALERT' | 'HIGHER_EDUCATION' | 'MARKETING' | 'POLLING_VOTING' | 'PUBLIC_SERVICE_ANNOUNCEMENT' | 'SECURITY_ALERT')>;
             description: string;
             /**
-             * How a recipient ends up receiving your messages (the opt-in flow).
+             * How a recipient ends up receiving your messages (the opt-in flow). Include a link to the page or form where they opt in — carrier reviewers reject campaigns whose consent they can't verify.
              */
             messageFlow: string;
             sample1: string;
@@ -17166,6 +17173,17 @@ export type GetSmsRegistrationResponse = ({
     declineReason?: (string) | null;
     phoneNumbers?: Array<(string)>;
     awaitingOtp?: boolean;
+    /**
+     * The submitted campaign content, present only for rejected
+     * registrations with a campaign. Edit and resubmit it via the
+     * appeal endpoint's optional content fields.
+     *
+     */
+    campaignContent?: {
+        messageFlow?: string;
+        sample1?: string;
+        sample2?: string;
+    };
 });
 
 export type GetSmsRegistrationError = ({
@@ -17191,7 +17209,16 @@ export type VerifySmsRegistrationOtpError = ({
 
 export type AppealSmsRegistrationData = {
     body: {
+        /**
+         * Goes verbatim to the carrier reviewer — address the decline reason directly.
+         */
         appealReason: string;
+        /**
+         * Corrected opt-in flow; include a link to the opt-in page/form.
+         */
+        messageFlow?: string;
+        sample1?: string;
+        sample2?: string;
     };
     path: {
         id: string;