@polar-sh/sdk 0.27.0 → 0.28.0

package/src/mcp-server/tools/subscriptionsUpdate.ts

@@ -17,6 +17,7 @@ export const tool$subscriptionsUpdate: ToolDefinition<typeof args> = {
 Update a subscription.
 
 **Scopes**: \`subscriptions:write\``,
+  scopes: ["write", "subscriptions"],
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await subscriptionsUpdate(

package/src/models/components/checkoutpricecreate.ts

@@ -69,6 +69,10 @@ export type CheckoutPriceCreate = {
    * ID of an existing customer in the organization. The customer data will be pre-filled in the checkout form. The resulting order will be linked to this customer.
    */
   customerId?: string | null | undefined;
+  /**
+   * ID of the customer in your system. If a matching customer exists on Polar, the resulting order will be linked to this customer. Otherwise, a new customer will be created with this external ID set.
+   */
+  customerExternalId?: string | null | undefined;
   customerName?: string | null | undefined;
   customerEmail?: string | null | undefined;
   customerIpAddress?: string | null | undefined;
@@ -301,6 +305,7 @@ export const CheckoutPriceCreate$inboundSchema: z.ZodType<
   allow_discount_codes: z.boolean().default(true),
   amount: z.nullable(z.number().int()).optional(),
   customer_id: z.nullable(z.string()).optional(),
+  customer_external_id: z.nullable(z.string()).optional(),
   customer_name: z.nullable(z.string()).optional(),
   customer_email: z.nullable(z.string()).optional(),
   customer_ip_address: z.nullable(z.string()).optional(),
@@ -319,6 +324,7 @@ export const CheckoutPriceCreate$inboundSchema: z.ZodType<
     "discount_id": "discountId",
     "allow_discount_codes": "allowDiscountCodes",
     "customer_id": "customerId",
+    "customer_external_id": "customerExternalId",
     "customer_name": "customerName",
     "customer_email": "customerEmail",
     "customer_ip_address": "customerIpAddress",
@@ -342,6 +348,7 @@ export type CheckoutPriceCreate$Outbound = {
   allow_discount_codes: boolean;
   amount?: number | null | undefined;
   customer_id?: string | null | undefined;
+  customer_external_id?: string | null | undefined;
   customer_name?: string | null | undefined;
   customer_email?: string | null | undefined;
   customer_ip_address?: string | null | undefined;
@@ -376,6 +383,7 @@ export const CheckoutPriceCreate$outboundSchema: z.ZodType<
   allowDiscountCodes: z.boolean().default(true),
   amount: z.nullable(z.number().int()).optional(),
   customerId: z.nullable(z.string()).optional(),
+  customerExternalId: z.nullable(z.string()).optional(),
   customerName: z.nullable(z.string()).optional(),
   customerEmail: z.nullable(z.string()).optional(),
   customerIpAddress: z.nullable(z.string()).optional(),
@@ -394,6 +402,7 @@ export const CheckoutPriceCreate$outboundSchema: z.ZodType<
     discountId: "discount_id",
     allowDiscountCodes: "allow_discount_codes",
     customerId: "customer_id",
+    customerExternalId: "customer_external_id",
     customerName: "customer_name",
     customerEmail: "customer_email",
     customerIpAddress: "customer_ip_address",

package/src/models/components/checkoutproductcreate.ts

@@ -69,6 +69,10 @@ export type CheckoutProductCreate = {
    * ID of an existing customer in the organization. The customer data will be pre-filled in the checkout form. The resulting order will be linked to this customer.
    */
   customerId?: string | null | undefined;
+  /**
+   * ID of the customer in your system. If a matching customer exists on Polar, the resulting order will be linked to this customer. Otherwise, a new customer will be created with this external ID set.
+   */
+  customerExternalId?: string | null | undefined;
   customerName?: string | null | undefined;
   customerEmail?: string | null | undefined;
   customerIpAddress?: string | null | undefined;
@@ -302,6 +306,7 @@ export const CheckoutProductCreate$inboundSchema: z.ZodType<
   allow_discount_codes: z.boolean().default(true),
   amount: z.nullable(z.number().int()).optional(),
   customer_id: z.nullable(z.string()).optional(),
+  customer_external_id: z.nullable(z.string()).optional(),
   customer_name: z.nullable(z.string()).optional(),
   customer_email: z.nullable(z.string()).optional(),
   customer_ip_address: z.nullable(z.string()).optional(),
@@ -320,6 +325,7 @@ export const CheckoutProductCreate$inboundSchema: z.ZodType<
     "discount_id": "discountId",
     "allow_discount_codes": "allowDiscountCodes",
     "customer_id": "customerId",
+    "customer_external_id": "customerExternalId",
     "customer_name": "customerName",
     "customer_email": "customerEmail",
     "customer_ip_address": "customerIpAddress",
@@ -343,6 +349,7 @@ export type CheckoutProductCreate$Outbound = {
   allow_discount_codes: boolean;
   amount?: number | null | undefined;
   customer_id?: string | null | undefined;
+  customer_external_id?: string | null | undefined;
   customer_name?: string | null | undefined;
   customer_email?: string | null | undefined;
   customer_ip_address?: string | null | undefined;
@@ -377,6 +384,7 @@ export const CheckoutProductCreate$outboundSchema: z.ZodType<
   allowDiscountCodes: z.boolean().default(true),
   amount: z.nullable(z.number().int()).optional(),
   customerId: z.nullable(z.string()).optional(),
+  customerExternalId: z.nullable(z.string()).optional(),
   customerName: z.nullable(z.string()).optional(),
   customerEmail: z.nullable(z.string()).optional(),
   customerIpAddress: z.nullable(z.string()).optional(),
@@ -395,6 +403,7 @@ export const CheckoutProductCreate$outboundSchema: z.ZodType<
     discountId: "discount_id",
     allowDiscountCodes: "allow_discount_codes",
     customerId: "customer_id",
+    customerExternalId: "customer_external_id",
     customerName: "customer_name",
     customerEmail: "customer_email",
     customerIpAddress: "customer_ip_address",

package/src/models/components/checkoutproductscreate.ts

@@ -68,6 +68,10 @@ export type CheckoutProductsCreate = {
    * ID of an existing customer in the organization. The customer data will be pre-filled in the checkout form. The resulting order will be linked to this customer.
    */
   customerId?: string | null | undefined;
+  /**
+   * ID of the customer in your system. If a matching customer exists on Polar, the resulting order will be linked to this customer. Otherwise, a new customer will be created with this external ID set.
+   */
+  customerExternalId?: string | null | undefined;
   customerName?: string | null | undefined;
   customerEmail?: string | null | undefined;
   customerIpAddress?: string | null | undefined;
@@ -302,6 +306,7 @@ export const CheckoutProductsCreate$inboundSchema: z.ZodType<
   allow_discount_codes: z.boolean().default(true),
   amount: z.nullable(z.number().int()).optional(),
   customer_id: z.nullable(z.string()).optional(),
+  customer_external_id: z.nullable(z.string()).optional(),
   customer_name: z.nullable(z.string()).optional(),
   customer_email: z.nullable(z.string()).optional(),
   customer_ip_address: z.nullable(z.string()).optional(),
@@ -320,6 +325,7 @@ export const CheckoutProductsCreate$inboundSchema: z.ZodType<
     "discount_id": "discountId",
     "allow_discount_codes": "allowDiscountCodes",
     "customer_id": "customerId",
+    "customer_external_id": "customerExternalId",
     "customer_name": "customerName",
     "customer_email": "customerEmail",
     "customer_ip_address": "customerIpAddress",
@@ -342,6 +348,7 @@ export type CheckoutProductsCreate$Outbound = {
   allow_discount_codes: boolean;
   amount?: number | null | undefined;
   customer_id?: string | null | undefined;
+  customer_external_id?: string | null | undefined;
   customer_name?: string | null | undefined;
   customer_email?: string | null | undefined;
   customer_ip_address?: string | null | undefined;
@@ -376,6 +383,7 @@ export const CheckoutProductsCreate$outboundSchema: z.ZodType<
   allowDiscountCodes: z.boolean().default(true),
   amount: z.nullable(z.number().int()).optional(),
   customerId: z.nullable(z.string()).optional(),
+  customerExternalId: z.nullable(z.string()).optional(),
   customerName: z.nullable(z.string()).optional(),
   customerEmail: z.nullable(z.string()).optional(),
   customerIpAddress: z.nullable(z.string()).optional(),
@@ -394,6 +402,7 @@ export const CheckoutProductsCreate$outboundSchema: z.ZodType<
     discountId: "discount_id",
     allowDiscountCodes: "allow_discount_codes",
     customerId: "customer_id",
+    customerExternalId: "customer_external_id",
     customerName: "customer_name",
     customerEmail: "customer_email",
     customerIpAddress: "customer_ip_address",

package/src/models/components/customer.ts

@@ -40,7 +40,17 @@ export type Customer = {
    */
   id: string;
   metadata: { [k: string]: string | number | boolean };
+  /**
+   * The ID of the customer in your system. This must be unique within the organization. Once set, it can't be updated.
+   */
+  externalId: string | null;
+  /**
+   * The email address of the customer. This must be unique within the organization.
+   */
   email: string;
+  /**
+   * Whether the customer email address is verified. The address is automatically verified when the customer accesses the customer portal using their email address.
+   */
   emailVerified: boolean;
   name: string | null;
   billingAddress: Address | null;
@@ -153,6 +163,7 @@ export const Customer$inboundSchema: z.ZodType<
   ),
   id: z.string(),
   metadata: z.record(z.union([z.string(), z.number().int(), z.boolean()])),
+  external_id: z.nullable(z.string()),
   email: z.string(),
   email_verified: z.boolean(),
   name: z.nullable(z.string()),
@@ -166,6 +177,7 @@ export const Customer$inboundSchema: z.ZodType<
   return remap$(v, {
     "created_at": "createdAt",
     "modified_at": "modifiedAt",
+    "external_id": "externalId",
     "email_verified": "emailVerified",
     "billing_address": "billingAddress",
     "tax_id": "taxId",
@@ -180,6 +192,7 @@ export type Customer$Outbound = {
   modified_at: string | null;
   id: string;
   metadata: { [k: string]: string | number | boolean };
+  external_id: string | null;
   email: string;
   email_verified: boolean;
   name: string | null;
@@ -199,6 +212,7 @@ export const Customer$outboundSchema: z.ZodType<
   modifiedAt: z.nullable(z.date().transform(v => v.toISOString())),
   id: z.string(),
   metadata: z.record(z.union([z.string(), z.number().int(), z.boolean()])),
+  externalId: z.nullable(z.string()),
   email: z.string(),
   emailVerified: z.boolean(),
   name: z.nullable(z.string()),
@@ -212,6 +226,7 @@ export const Customer$outboundSchema: z.ZodType<
   return remap$(v, {
     createdAt: "created_at",
     modifiedAt: "modified_at",
+    externalId: "external_id",
     emailVerified: "email_verified",
     billingAddress: "billing_address",
     taxId: "tax_id",

package/src/models/components/customercreate.ts

@@ -39,6 +39,13 @@ export type CustomerCreate = {
    * You can store up to **50 key-value pairs**.
    */
   metadata?: { [k: string]: string | number | boolean } | undefined;
+  /**
+   * The ID of the customer in your system. This must be unique within the organization. Once set, it can't be updated.
+   */
+  externalId?: string | null | undefined;
+  /**
+   * The email address of the customer. This must be unique within the organization.
+   */
   email: string;
   name?: string | null | undefined;
   billingAddress?: Address | null | undefined;
@@ -153,6 +160,7 @@ export const CustomerCreate$inboundSchema: z.ZodType<
 > = z.object({
   metadata: z.record(z.union([z.string(), z.number().int(), z.boolean()]))
     .optional(),
+  external_id: z.nullable(z.string()).optional(),
   email: z.string(),
   name: z.nullable(z.string()).optional(),
   billing_address: z.nullable(Address$inboundSchema).optional(),
@@ -162,6 +170,7 @@ export const CustomerCreate$inboundSchema: z.ZodType<
   organization_id: z.nullable(z.string()).optional(),
 }).transform((v) => {
   return remap$(v, {
+    "external_id": "externalId",
     "billing_address": "billingAddress",
     "tax_id": "taxId",
     "organization_id": "organizationId",
@@ -171,6 +180,7 @@ export const CustomerCreate$inboundSchema: z.ZodType<
 /** @internal */
 export type CustomerCreate$Outbound = {
   metadata?: { [k: string]: string | number | boolean } | undefined;
+  external_id?: string | null | undefined;
   email: string;
   name?: string | null | undefined;
   billing_address?: Address$Outbound | null | undefined;
@@ -186,6 +196,7 @@ export const CustomerCreate$outboundSchema: z.ZodType<
 > = z.object({
   metadata: z.record(z.union([z.string(), z.number().int(), z.boolean()]))
     .optional(),
+  externalId: z.nullable(z.string()).optional(),
   email: z.string(),
   name: z.nullable(z.string()).optional(),
   billingAddress: z.nullable(Address$outboundSchema).optional(),
@@ -195,6 +206,7 @@ export const CustomerCreate$outboundSchema: z.ZodType<
   organizationId: z.nullable(z.string()).optional(),
 }).transform((v) => {
   return remap$(v, {
+    externalId: "external_id",
     billingAddress: "billing_address",
     taxId: "tax_id",
     organizationId: "organization_id",

package/src/models/components/customersessioncustomerexternalidcreate.ts

@@ -0,0 +1,92 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+/**
+ * Schema for creating a customer session using an external customer ID.
+ */
+export type CustomerSessionCustomerExternalIDCreate = {
+  /**
+   * External ID of the customer to create a session for.
+   */
+  customerExternalId: string;
+};
+
+/** @internal */
+export const CustomerSessionCustomerExternalIDCreate$inboundSchema: z.ZodType<
+  CustomerSessionCustomerExternalIDCreate,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  customer_external_id: z.string(),
+}).transform((v) => {
+  return remap$(v, {
+    "customer_external_id": "customerExternalId",
+  });
+});
+
+/** @internal */
+export type CustomerSessionCustomerExternalIDCreate$Outbound = {
+  customer_external_id: string;
+};
+
+/** @internal */
+export const CustomerSessionCustomerExternalIDCreate$outboundSchema: z.ZodType<
+  CustomerSessionCustomerExternalIDCreate$Outbound,
+  z.ZodTypeDef,
+  CustomerSessionCustomerExternalIDCreate
+> = z.object({
+  customerExternalId: z.string(),
+}).transform((v) => {
+  return remap$(v, {
+    customerExternalId: "customer_external_id",
+  });
+});
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace CustomerSessionCustomerExternalIDCreate$ {
+  /** @deprecated use `CustomerSessionCustomerExternalIDCreate$inboundSchema` instead. */
+  export const inboundSchema =
+    CustomerSessionCustomerExternalIDCreate$inboundSchema;
+  /** @deprecated use `CustomerSessionCustomerExternalIDCreate$outboundSchema` instead. */
+  export const outboundSchema =
+    CustomerSessionCustomerExternalIDCreate$outboundSchema;
+  /** @deprecated use `CustomerSessionCustomerExternalIDCreate$Outbound` instead. */
+  export type Outbound = CustomerSessionCustomerExternalIDCreate$Outbound;
+}
+
+export function customerSessionCustomerExternalIDCreateToJSON(
+  customerSessionCustomerExternalIDCreate:
+    CustomerSessionCustomerExternalIDCreate,
+): string {
+  return JSON.stringify(
+    CustomerSessionCustomerExternalIDCreate$outboundSchema.parse(
+      customerSessionCustomerExternalIDCreate,
+    ),
+  );
+}
+
+export function customerSessionCustomerExternalIDCreateFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  CustomerSessionCustomerExternalIDCreate,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      CustomerSessionCustomerExternalIDCreate$inboundSchema.parse(
+        JSON.parse(x),
+      ),
+    `Failed to parse 'CustomerSessionCustomerExternalIDCreate' from JSON`,
+  );
+}

package/src/models/components/customersessioncustomeridcreate.ts

@@ -0,0 +1,83 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+/**
+ * Schema for creating a customer session using a customer ID.
+ */
+export type CustomerSessionCustomerIDCreate = {
+  /**
+   * ID of the customer to create a session for.
+   */
+  customerId: string;
+};
+
+/** @internal */
+export const CustomerSessionCustomerIDCreate$inboundSchema: z.ZodType<
+  CustomerSessionCustomerIDCreate,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  customer_id: z.string(),
+}).transform((v) => {
+  return remap$(v, {
+    "customer_id": "customerId",
+  });
+});
+
+/** @internal */
+export type CustomerSessionCustomerIDCreate$Outbound = {
+  customer_id: string;
+};
+
+/** @internal */
+export const CustomerSessionCustomerIDCreate$outboundSchema: z.ZodType<
+  CustomerSessionCustomerIDCreate$Outbound,
+  z.ZodTypeDef,
+  CustomerSessionCustomerIDCreate
+> = z.object({
+  customerId: z.string(),
+}).transform((v) => {
+  return remap$(v, {
+    customerId: "customer_id",
+  });
+});
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace CustomerSessionCustomerIDCreate$ {
+  /** @deprecated use `CustomerSessionCustomerIDCreate$inboundSchema` instead. */
+  export const inboundSchema = CustomerSessionCustomerIDCreate$inboundSchema;
+  /** @deprecated use `CustomerSessionCustomerIDCreate$outboundSchema` instead. */
+  export const outboundSchema = CustomerSessionCustomerIDCreate$outboundSchema;
+  /** @deprecated use `CustomerSessionCustomerIDCreate$Outbound` instead. */
+  export type Outbound = CustomerSessionCustomerIDCreate$Outbound;
+}
+
+export function customerSessionCustomerIDCreateToJSON(
+  customerSessionCustomerIDCreate: CustomerSessionCustomerIDCreate,
+): string {
+  return JSON.stringify(
+    CustomerSessionCustomerIDCreate$outboundSchema.parse(
+      customerSessionCustomerIDCreate,
+    ),
+  );
+}
+
+export function customerSessionCustomerIDCreateFromJSON(
+  jsonString: string,
+): SafeParseResult<CustomerSessionCustomerIDCreate, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => CustomerSessionCustomerIDCreate$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CustomerSessionCustomerIDCreate' from JSON`,
+  );
+}

package/src/models/components/customerupdate.ts

@@ -25,6 +25,13 @@ export type CustomerUpdateTaxId = string | TaxIDFormat;
 
 export type CustomerUpdate = {
   metadata?: { [k: string]: string | number | boolean } | null | undefined;
+  /**
+   * The ID of the customer in your system. This must be unique within the organization. Once set, it can't be updated.
+   */
+  externalId?: string | null | undefined;
+  /**
+   * The email address of the customer. This must be unique within the organization.
+   */
   email?: string | null | undefined;
   name?: string | null | undefined;
   billingAddress?: Address | null | undefined;
@@ -136,6 +143,7 @@ export const CustomerUpdate$inboundSchema: z.ZodType<
   metadata: z.nullable(
     z.record(z.union([z.string(), z.number().int(), z.boolean()])),
   ).optional(),
+  external_id: z.nullable(z.string()).optional(),
   email: z.nullable(z.string()).optional(),
   name: z.nullable(z.string()).optional(),
   billing_address: z.nullable(Address$inboundSchema).optional(),
@@ -144,6 +152,7 @@ export const CustomerUpdate$inboundSchema: z.ZodType<
   ).optional(),
 }).transform((v) => {
   return remap$(v, {
+    "external_id": "externalId",
     "billing_address": "billingAddress",
     "tax_id": "taxId",
   });
@@ -152,6 +161,7 @@ export const CustomerUpdate$inboundSchema: z.ZodType<
 /** @internal */
 export type CustomerUpdate$Outbound = {
   metadata?: { [k: string]: string | number | boolean } | null | undefined;
+  external_id?: string | null | undefined;
   email?: string | null | undefined;
   name?: string | null | undefined;
   billing_address?: Address$Outbound | null | undefined;
@@ -167,6 +177,7 @@ export const CustomerUpdate$outboundSchema: z.ZodType<
   metadata: z.nullable(
     z.record(z.union([z.string(), z.number().int(), z.boolean()])),
   ).optional(),
+  externalId: z.nullable(z.string()).optional(),
   email: z.nullable(z.string()).optional(),
   name: z.nullable(z.string()).optional(),
   billingAddress: z.nullable(Address$outboundSchema).optional(),
@@ -175,6 +186,7 @@ export const CustomerUpdate$outboundSchema: z.ZodType<
   ).optional(),
 }).transform((v) => {
   return remap$(v, {
+    externalId: "external_id",
     billingAddress: "billing_address",
     taxId: "tax_id",
   });

package/src/models/components/licensekeycustomer.ts

@@ -37,7 +37,17 @@ export type LicenseKeyCustomer = {
    */
   id: string;
   metadata: { [k: string]: string | number | boolean };
+  /**
+   * The ID of the customer in your system. This must be unique within the organization. Once set, it can't be updated.
+   */
+  externalId: string | null;
+  /**
+   * The email address of the customer. This must be unique within the organization.
+   */
   email: string;
+  /**
+   * Whether the customer email address is verified. The address is automatically verified when the customer accesses the customer portal using their email address.
+   */
   emailVerified: boolean;
   name: string | null;
   billingAddress: Address | null;
@@ -154,6 +164,7 @@ export const LicenseKeyCustomer$inboundSchema: z.ZodType<
   ),
   id: z.string(),
   metadata: z.record(z.union([z.string(), z.number().int(), z.boolean()])),
+  external_id: z.nullable(z.string()),
   email: z.string(),
   email_verified: z.boolean(),
   name: z.nullable(z.string()),
@@ -167,6 +178,7 @@ export const LicenseKeyCustomer$inboundSchema: z.ZodType<
   return remap$(v, {
     "created_at": "createdAt",
     "modified_at": "modifiedAt",
+    "external_id": "externalId",
     "email_verified": "emailVerified",
     "billing_address": "billingAddress",
     "tax_id": "taxId",
@@ -181,6 +193,7 @@ export type LicenseKeyCustomer$Outbound = {
   modified_at: string | null;
   id: string;
   metadata: { [k: string]: string | number | boolean };
+  external_id: string | null;
   email: string;
   email_verified: boolean;
   name: string | null;
@@ -200,6 +213,7 @@ export const LicenseKeyCustomer$outboundSchema: z.ZodType<
   modifiedAt: z.nullable(z.date().transform(v => v.toISOString())),
   id: z.string(),
   metadata: z.record(z.union([z.string(), z.number().int(), z.boolean()])),
+  externalId: z.nullable(z.string()),
   email: z.string(),
   emailVerified: z.boolean(),
   name: z.nullable(z.string()),
@@ -213,6 +227,7 @@ export const LicenseKeyCustomer$outboundSchema: z.ZodType<
   return remap$(v, {
     createdAt: "created_at",
     modifiedAt: "modified_at",
+    externalId: "external_id",
     emailVerified: "email_verified",
     billingAddress: "billing_address",
     taxId: "tax_id",

package/src/models/components/ordercustomer.ts

@@ -37,7 +37,17 @@ export type OrderCustomer = {
    */
   id: string;
   metadata: { [k: string]: string | number | boolean };
+  /**
+   * The ID of the customer in your system. This must be unique within the organization. Once set, it can't be updated.
+   */
+  externalId: string | null;
+  /**
+   * The email address of the customer. This must be unique within the organization.
+   */
   email: string;
+  /**
+   * Whether the customer email address is verified. The address is automatically verified when the customer accesses the customer portal using their email address.
+   */
   emailVerified: boolean;
   name: string | null;
   billingAddress: Address | null;
@@ -154,6 +164,7 @@ export const OrderCustomer$inboundSchema: z.ZodType<
   ),
   id: z.string(),
   metadata: z.record(z.union([z.string(), z.number().int(), z.boolean()])),
+  external_id: z.nullable(z.string()),
   email: z.string(),
   email_verified: z.boolean(),
   name: z.nullable(z.string()),
@@ -167,6 +178,7 @@ export const OrderCustomer$inboundSchema: z.ZodType<
   return remap$(v, {
     "created_at": "createdAt",
     "modified_at": "modifiedAt",
+    "external_id": "externalId",
     "email_verified": "emailVerified",
     "billing_address": "billingAddress",
     "tax_id": "taxId",
@@ -181,6 +193,7 @@ export type OrderCustomer$Outbound = {
   modified_at: string | null;
   id: string;
   metadata: { [k: string]: string | number | boolean };
+  external_id: string | null;
   email: string;
   email_verified: boolean;
   name: string | null;
@@ -200,6 +213,7 @@ export const OrderCustomer$outboundSchema: z.ZodType<
   modifiedAt: z.nullable(z.date().transform(v => v.toISOString())),
   id: z.string(),
   metadata: z.record(z.union([z.string(), z.number().int(), z.boolean()])),
+  externalId: z.nullable(z.string()),
   email: z.string(),
   emailVerified: z.boolean(),
   name: z.nullable(z.string()),
@@ -213,6 +227,7 @@ export const OrderCustomer$outboundSchema: z.ZodType<
   return remap$(v, {
     createdAt: "created_at",
     modifiedAt: "modified_at",
+    externalId: "external_id",
     emailVerified: "email_verified",
     billingAddress: "billing_address",
     taxId: "tax_id",

package/src/models/components/subscriptioncustomer.ts

@@ -37,7 +37,17 @@ export type SubscriptionCustomer = {
    */
   id: string;
   metadata: { [k: string]: string | number | boolean };
+  /**
+   * The ID of the customer in your system. This must be unique within the organization. Once set, it can't be updated.
+   */
+  externalId: string | null;
+  /**
+   * The email address of the customer. This must be unique within the organization.
+   */
   email: string;
+  /**
+   * Whether the customer email address is verified. The address is automatically verified when the customer accesses the customer portal using their email address.
+   */
   emailVerified: boolean;
   name: string | null;
   billingAddress: Address | null;
@@ -149,6 +159,7 @@ export const SubscriptionCustomer$inboundSchema: z.ZodType<
   ),
   id: z.string(),
   metadata: z.record(z.union([z.string(), z.number().int(), z.boolean()])),
+  external_id: z.nullable(z.string()),
   email: z.string(),
   email_verified: z.boolean(),
   name: z.nullable(z.string()),
@@ -162,6 +173,7 @@ export const SubscriptionCustomer$inboundSchema: z.ZodType<
   return remap$(v, {
     "created_at": "createdAt",
     "modified_at": "modifiedAt",
+    "external_id": "externalId",
     "email_verified": "emailVerified",
     "billing_address": "billingAddress",
     "tax_id": "taxId",
@@ -176,6 +188,7 @@ export type SubscriptionCustomer$Outbound = {
   modified_at: string | null;
   id: string;
   metadata: { [k: string]: string | number | boolean };
+  external_id: string | null;
   email: string;
   email_verified: boolean;
   name: string | null;
@@ -195,6 +208,7 @@ export const SubscriptionCustomer$outboundSchema: z.ZodType<
   modifiedAt: z.nullable(z.date().transform(v => v.toISOString())),
   id: z.string(),
   metadata: z.record(z.union([z.string(), z.number().int(), z.boolean()])),
+  externalId: z.nullable(z.string()),
   email: z.string(),
   emailVerified: z.boolean(),
   name: z.nullable(z.string()),
@@ -208,6 +222,7 @@ export const SubscriptionCustomer$outboundSchema: z.ZodType<
   return remap$(v, {
     createdAt: "created_at",
     modifiedAt: "modified_at",
+    externalId: "external_id",
     emailVerified: "email_verified",
     billingAddress: "billing_address",
     taxId: "tax_id",