POST
/
v1
/
tenants
/
:tenantId
/
api-keys
curl https://api.geldstuck.com/v1/tenants/$TENANT_ID/api-keys \
  -H "x-api-key: $GELDSTUCK_PUBLIC_KEY" \
  -H "x-api-secret: $GELDSTUCK_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"label": "billing-worker"}'

{
  "id": "key_01HX3ZDE...",
  "label": "billing-worker",
  "publicKey": "pk_live_51H...",
  "secretKey": "sk_live_51H...",
  "status": "active",
  "createdAt": "2026-04-22T10:00:00.000Z"
}
Creates a new API key pair. The secretKey is returned once - store it securely.

​
Path parameters

​
tenantId
string
required

​
Body

​
label
string
required
Human-readable label, e.g. billing-worker. Label your keys per service for precise revocation.

​
Returns

​
id
string
Key ID (key_...), used for revoke/regenerate.
​
publicKey
string
​
secretKey
string
Shown once.
​
label
string
​
status
string
​
createdAt
string
curl https://api.geldstuck.com/v1/tenants/$TENANT_ID/api-keys \
  -H "x-api-key: $GELDSTUCK_PUBLIC_KEY" \
  -H "x-api-secret: $GELDSTUCK_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"label": "billing-worker"}'

{
  "id": "key_01HX3ZDE...",
  "label": "billing-worker",
  "publicKey": "pk_live_51H...",
  "secretKey": "sk_live_51H...",
  "status": "active",
  "createdAt": "2026-04-22T10:00:00.000Z"
}