Create a workspace

POSThttps://myagentmail.com/v1/workspaces

Requires a tenant master key (tk_...). Workspaces are isolation containers — inboxes and domains created in one cannot be seen from another.

Request body

Content-Type: application/json

`name` required string
`slug` string

Responses

201application/jsonCreated

`id` required string	format: uuid
`name` required string
`slug` required string
`isDefault` required boolean
`inboxCount` integer
`domainCount` integer
`createdAt` string	format: date-time

400application/jsonRequest body failed schema validation

`error` required string
`code` string

401application/jsonMissing or invalid API key

`error` required string
`code` string

Authentication

Send your API key in the X-API-Key header (or Authorization: Bearer <key>). Any prefix accepted by this endpoint — tk_, wk_, ak_, or sa_ — is documented in the key prefix table.

Request

import { MyAgentMail } from "myagentmail";

const client = new MyAgentMail({ apiKey: process.env.MYAGENTMAIL_API_KEY! });

// POST /v1/workspaces
const result = await client.request("post", "/v1/workspaces", { body: {
  "name": "Recruiter Corp",
  "slug": "recruiter-corp"
} });

Example response · 201

{
  "id": "00000000-0000-0000-0000-000000000000",
  "name": "Recruiter Corp",
  "slug": "recruiter-corp",
  "isDefault": false,
  "inboxCount": 0,
  "domainCount": 0,
  "createdAt": "2026-05-01T08:11:44.703Z"
}