@sendmailos/sdk 1.3.0 → 1.3.2

package/README.md

@@ -315,6 +315,53 @@ await platform.campaigns.send({
 
 **One verified domain = One workspace.** Simple.
 
+### Master API Keys
+
+Master API keys can access all workspaces in your organization with a single key. Ideal for SaaS platforms that need to manage multiple client workspaces programmatically.
+
+#### Recommended Flow for SaaS Platforms
+
+```typescript
+// Your platform backend - when a new client signs up
+const platform = new SendMailOS('sk_live_master_key');
+
+// 1. Create workspace first (with your client's data)
+const { workspace } = await platform.workspaces.create({
+  name: 'Pizza Palace',           // From your user's profile
+  industry: 'restaurants',        // Optional - can be null
+  website: 'https://pizzapalace.com'
+});
+
+// 2. Add domain TO that workspace
+const { dns_records } = await platform.domains.create({
+  domain: 'pizzapalace.com',
+  workspaceId: workspace.id       // Link to the workspace
+});
+
+// 3. Show DNS records to your user
+// They verify DNS, domain becomes active
+
+// 4. Now send emails using workspace_id or domain
+await platform.emails.send({
+  to: 'customer@example.com',
+  fromEmail: 'hello@pizzapalace.com',
+  subject: 'Welcome!',
+  html: '<h1>Welcome!</h1>',
+  workspaceId: workspace.id
+});
+```
+
+Your end users only see: **"Add domain → Verify DNS → Done"**
+
+Behind the scenes: Workspace created with proper settings → Domain linked → Ready to send.
+
+**Master Key vs Workspace Key:**
+| Feature | Master Key | Workspace Key |
+|---------|-----------|---------------|
+| Access | All workspaces | Single workspace |
+| workspaceId param | Required | Not needed |
+| Use case | Platform/SaaS backend | Per-client integrations |
+
 ## Agency Workspaces (Advanced)
 
 For more control, you can manually manage workspaces:

package/dist/index.d.mts

@@ -2,7 +2,7 @@
  * SendMailOS SDK Types
  */
 interface SendMailOSOptions {
-    /** Base URL for the API (default: https://api.sendmailos.com) */
+    /** Base URL for the API (default: https://sendmailos.com) */
     baseUrl?: string;
     /** Request timeout in milliseconds (default: 30000) */
     timeout?: number;

package/dist/index.d.ts

@@ -2,7 +2,7 @@
  * SendMailOS SDK Types
  */
 interface SendMailOSOptions {
-    /** Base URL for the API (default: https://api.sendmailos.com) */
+    /** Base URL for the API (default: https://sendmailos.com) */
     baseUrl?: string;
     /** Request timeout in milliseconds (default: 30000) */
     timeout?: number;

package/dist/index.js

@@ -1001,9 +1001,9 @@ var WebhooksResource = class {
 };
 
 // src/client.ts
-var DEFAULT_BASE_URL = "https://api.sendmailos.com/api/v1";
+var DEFAULT_BASE_URL = "https://sendmailos.com/api/v1";
 var DEFAULT_TIMEOUT = 3e4;
-var SDK_VERSION = "1.2.0";
+var SDK_VERSION = "1.3.2";
 var SendMailOS = class {
   constructor(apiKey, options = {}) {
     if (!apiKey) {