Create a sub-account API key

Creates a sandbox or production API key for a sub-account. Treat the returned key value as a secret. For rotation, create a replacement, cut traffic over, then revoke the old key.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

sub_account_idstringRequired

Sub-account ID

Request

This endpoint expects an object.

namestringRequired

environmentenumRequired

Allowed values:

Response

sub-account API key created

objectenum

idstringformat: "uuid"

namestring

valuestring

live_modeboolean

created_atdatetime

updated_atdatetime

api_versionenum

Errors

400

Create Sub Account API Key Request Bad Request Error

403

Create Sub Account API Key Request Forbidden Error

404

Create Sub Account API Key Request Not Found Error

$	curl -X POST https://api.middesk.com/v1/sub_accounts/sub_account_id/api_keys \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "Production Key",
>	"environment": "production"
>	}'

1	{
2	"object": "api_key",
3	"id": "23a7d602-7153-4209-8fd4-dda17f33374d",
4	"name": "Production Key",
5	"value": "mk_live_0123456789abcdef01234567",
6	"live_mode": true,
7	"created_at": "2026-08-17T19:00:00Z",
8	"updated_at": "2026-08-17T19:00:00Z",
9	"api_version": "2020-05-11"
10	}