Skip to main content
A tenant is your workspace in Plinth. When you sign up, we create a tenant for your company. All your customers, plans, subscriptions, and invoices are scoped to that tenant. Nothing leaks between tenants.

​
Test vs live mode

Test mode gives you a fully functional sandbox. You can create customers, subscribe them to plans, advance the clock, trigger dunning — all without moving real money.Test keys start with sk_test_. Use them in your development and staging environments.The sandbox has pre-loaded test cards (including ones that fail) and pre-seeded plans. See the test clock guide for simulating time-sensitive flows.

​
API key format

Key typePrefixWhere to use
Test secret keysk_test_Development, staging, CI
Live secret keysk_live_Production only

​
Authenticating requests

Every API request requires your key in the Authorization header: 
curl https://api.useplinth.com/v1/customers \
  -H "Authorization: Bearer sk_test_YOUR_KEY"

import { Plinth } from '@nomba/sdk';

const client = new Plinth({
  apiKey: process.env.NOMBA_API_KEY!,
});
Never commit API keys to source control. Use environment variables. If a key is exposed, rotate it immediately from the dashboard — the old key stops working the moment you rotate.

​
Key rotation

Rotate keys from the dashboard. Issuing a new key doesn’t invalidate the old one until you explicitly revoke it — giving you time to update your deployment. To revoke via API: DELETE /v1/tenant/api-keys/{key_id}.