---
title: "Provision the workspace SES tenant"
method: POST
path: "/admin/ses-tenants/{workspace}/provision"
tags: ["admin"]
---

# Provision the workspace SES tenant

`POST /admin/ses-tenants/{workspace}/provision`

## Request

- Base URL: `https://api.mailly.site` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mailly.site/admin/ses-tenants/{workspace}/provision`
- Auth: HTTP bearer

Creates or reuses the workspace tenant and rechecks all resource associations (shared configuration set, platform domain, its verified sender domains). Idempotent; does not resume a paused tenant.

## Path parameters

- `workspace` string, required: Workspace ID (account email, case-insensitive, URL-encoded)

## Response `200`

Tenant is active

- object
  - `success` boolean, required
  - `tenant` object, nullable, required

## Other responses

- `400`: Invalid workspace ID
- `409`: SES_TENANT_PROVISIONING is not enabled on the queue
- `429`: SES rate limited; retry later
- `502`: Provisioning failed (see tenant.lastError)
- `503`: Queue is missing AWS credentials or is not bound

---

[API](https://skmtc.dev/mailly/apis/mailly-api.md) · [All operations](https://skmtc.dev/mailly/apis/mailly-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mailly/apis/mailly-api/revisions/1ceb29637301?raw)
