Skip to main content
POST
/
v1
/
admin
/
provision
Provision an org
curl --request POST \
  --url https://api.craftkit.dev/v1/admin/provision \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "externalOrgId": "org_123",
  "orgName": "Acme Corp"
}
'
{
  "projectId": "7c9f0b2e-2b1a-4f3d-9c8e-1a2b3c4d5e6f",
  "partnerId": "9a8b7c6d-5e4f-3a2b-1c0d-9e8f7a6b5c4d",
  "apiKey": "ck_live_xxxxxxxxxxxx",
  "alreadyExisted": false
}

Authorizations

​
Authorization
string
header
required

Deployment-wide admin secret (CRAFTKIT_ADMIN_KEY). Admin provisioning only.

Body

application/json
​
externalOrgId
string
required
​
orgName
string

Response

Org provisioned (returns whether it already existed).

​
projectId
string<uuid>
required
​
partnerId
string<uuid>
required
​
apiKey
string
required

Plaintext project API key (only retrievable via this endpoint).

​
alreadyExisted
boolean
required