Customers (TenaBill)
Customers are the bill-to parties in your merchant namespace. Every invoice and portal session is associated with a customer record. Customers are typically created programmatically via the API when a user registers in your product.
Console: TenaBill merchant console → Customers (/customers)
Customer records
Each customer has:
| Field | Description |
|---|---|
| Name | Display name for invoices and the portal |
| Used for portal magic-link delivery and invoice notifications | |
| External ID | Your system's identifier; use to correlate with your user database |
| Created | When the record was created in TenaBill |
Create customers
Customers are created via the TenaBill API:
http
POST /api/v1/console/customers
X-TenaBill-Api-Key: <your-key>
{
"name": "Acme Corp",
"email": "billing@acme.com",
"externalId": "usr_12345"
}The console list is read-only — creation is intentionally API-only to keep your product's user lifecycle the authoritative source.
Portal access
Customers access their invoices through the TenaBill billing portal. Send them a magic-link via POST /api/v1/portal/magic-link or through the invoices reminder flow.
Portal magic-link emails use the branding and templates configured in Settings → Branding.