Skip to main content
POST
/
tenants
cURL
curl -X POST "https://api.arkhq.io/v1/tenants" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Corp",
    "metadata": {
      "plan": "pro",
      "region": "us-west"
    }
  }'
{
  "success": true,
  "data": {
    "id": "cm6abc123def456",
    "name": "Acme Corp",
    "metadata": {
      "plan": "pro",
      "internalId": "cust_12345"
    },
    "status": "active",
    "createdAt": "2026-02-03T10:30:00Z",
    "updatedAt": "2026-02-03T10:30:00Z"
  },
  "meta": {
    "requestId": "req_abc123xyz"
  }
}

Authorizations

​
Authorization
string
header
required

Use your API key from arkhq.io/org/credentials

Authorization: Bearer YOUR_API_KEY

Body

application/json
​
name
string
required

Display name for the tenant (e.g., your customer's company name)

Required string length: 1 - 100
Example:

"Acme Corp"

​
metadata
object

Custom key-value pairs. Useful for storing references to your internal systems.

Limits:

  • Max 50 keys
  • Key names max 40 characters
  • String values max 500 characters
  • Total size max 8KB
Example:
{
  "plan": "pro",
  "internalId": "cust_12345",
  "region": "us-west"
}

Response

Tenant created

​
success
boolean
required
​
data
object
required
​
meta
object
required