API reference / Inboxes
Finish inbox setup
Retry delivery routing for a reserved inbox.
POST/v1/inboxes/{inboxId}/setup
Requires an API key with the inboxes:write scope. MCP tool: finish_inbox_setup. CLI: goshenemail inboxes finish-setup.
Request
Path parameters
| Name | Type | Required | Notes |
|---|---|---|---|
inboxId | string (email) | Yes | up to 254 characters |
Body
None.
Response
| Field | Type | Notes |
|---|---|---|
inboxId | string | |
address | string | |
displayName | string | |
createdAt | string | |
group | string | null | |
deliveryStatus | "pending" | "ready" | |
setupAvailable | boolean |
Errors return { "error": { "code", "message", "transient" } } with a 4xx or 5xx status. See Errors.
Examples
curl
curl "https://api.goshenemail.com/v1/inboxes/research%40agents.goshenemail.com/setup" \
-H "Authorization: Bearer $GOSHENEMAIL_API_KEY" \
-X POSTCLI
goshenemail inboxes finish-setup --inbox-id "research@agents.goshenemail.com"