{"uid":"cap_lvFr-BIiRHprBHMvAYJtb","slug":"agentmail-pods-67681cbb","name":"AgentMail Create Pod","description":"Create Pod","url":"https://mpp.api.agentmail.to/v0/pods?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","title":"CreatePodRequest","properties":{"name":{"type":"string","title":"Name","description":"Name of pod."},"client_id":{"type":"string","title":"ClientId","description":"Client ID of pod."}}},"responseSchema":{"type":"object","title":"Pod","required":["pod_id","name","updated_at","created_at"],"properties":{"name":{"type":"string","title":"Name","description":"Name of pod."},"pod_id":{"type":"string","title":"PodId","description":"ID of pod."},"client_id":{"type":"string","title":"ClientId","description":"Client ID of pod."},"created_at":{"type":"string","format":"date-time","description":"Time at which pod was created."},"updated_at":{"type":"string","format":"date-time","description":"Time at which pod was last updated."}}},"example":null,"exampleRequest":null,"tags":["email","inboxes","domains","drafts","threads","webhooks","messaging","ai","social"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"1.00","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"unknown","summary":"$0.01/call","primary":{"kind":"unknown","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"unknown","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_twO4oIUtB2vQWWzjvPA5W","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"AgentMail","brandSlug":"agentmail","brandBaseUrl":"https://agentmail.to","brandDocsUrl":"https://docs.agentmail.to","whatItDoes":"Creates a new Pod (a named workspace/container for email inboxes) in the AgentMail system","exampleAgentPrompt":"Create a new AgentMail pod named 'customer-support-agent' for my application so I can start provisioning email inboxes under it.","exampleUseCases":[{"title":"Support inbox workspace for agent fleet","prompt":"Set up a new pod called 'support-team-workspace' so we can organize email inboxes for all our customer service agents in one place."},{"title":"Multi-tenant pod provisioning for clients","prompt":"Create a pod named 'acme-corp-agents' for our new enterprise client so they can start managing their AI agents' email accounts independently."},{"title":"Dedicated email management pod setup","prompt":"Initialize a fresh pod called 'sales-automation-hub' where I can set up and manage email inboxes for our outbound sales agent operations."}],"resultDescription":"Returns a Pod object containing the newly created pod's unique pod_id, name, optional client_id, and ISO 8601 timestamps for created_at and updated_at — all fields needed to reference and manage the pod going forward.","failureModes":["Missing or invalid Authorization header returns 401 Unauthorized","Duplicate pod name or client_id conflict may return 409 Conflict","Malformed request body returns 400 Bad Request","Service unavailable returns 503"],"whenToPreferThis":"Use this endpoint when you need to create a new top-level workspace (Pod) in AgentMail before provisioning email inboxes or domains for AI agents. This is the first step in the AgentMail setup flow — you must have a Pod before creating inboxes, threads, or webhooks under it.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-05-06T23:05:35.784Z","lastSuccessfullyRanAt":"2026-05-06T23:05:35.784Z","lastHealthCheckAt":"2026-10-11T18:30:19.520Z","isFirstParty":false,"canonicalSlug":"agentmail-pods-67681cbb"}