> ## Documentation Index
> Fetch the complete documentation index at: https://learn.nexudus.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Create Tariff
> Create a new Tariff record.
A **Tariff** (also called a Plan) is a membership plan that customers can sign up to in exchange for access to a coworking space and other benefits. Tariffs are the foundation for contracts — every time a customer signs up to a plan, Nexudus generates a `CoworkerContract` for that member based on the plan's settings.
Plans define billing frequency (in months or weeks via `InvoiceEvery` / `InvoiceEveryWeeks`), pricing, cancellation rules, and limits on check-ins, booking minutes, visitor passes, and hours. Members are invoiced at the end of each billing cycle. Plans can include benefits such as day passes, booking credits, and money credits — these are configured through `CoworkerExtraService` and `Product` entities linked to the contract.
Use `SystemTariffType` to categorise the plan (e.g. FullTimeHotDesk, VirtualOffice, Storage). Use `Visible` to control whether the plan appears on the members portal. Plans can optionally require identity checks before activation, enforce contract terms, support pausing, and define delivery handling preferences for virtual office mail.
When you edit a plan, changes impact all members signed up to that plan. To customise settings for an individual member, edit their `CoworkerContract` instead.
## Authentication
This endpoint requires OAuth2 authentication. Include a valid bearer token in the `Authorization` header.
The authenticated user must be a full unrestricted administrator or have the **`Tariff-Create`** role.
## Enums
| Value | Name |
| ----- | --------------------- |
| 1 | FullTimePrivateOffice |
| 2 | PartTimePrivateOffice |
| 3 | FullTimeDedicatedDesk |
| 4 | PartTimeDedicatedDesk |
| 5 | FullTimeHotDesk |
| 6 | PartTimeHotDesk |
| 7 | FullTimeOther |
| 8 | PartTimeOther |
| 9 | Storage |
| 10 | VirtualOffice |
| 11 | Virtual |
| 99 | Other |
| Value | Name |
| ----- | ------------------- |
| 1 | RenewalDate |
| 2 | BookingEndDate |
| 3 | BookingCreationDate |
| 4 | NextNthOfMonth |
| Value | Name |
| ----- | -------------- |
| 1 | Manual |
| 2 | StripeIdentity |
| Value | Name |
| ----- | ------------- |
| 1 | Never |
| 2 | Every3Months |
| 3 | Every6Months |
| 4 | Every12Months |
| 5 | Every24Months |
| Value | Name |
| ----- | -------------------------- |
| 1 | StoreForCollection |
| 2 | Forward |
| 3 | OpenScanForward |
| 4 | OpenScanRecycle |
| 5 | OpenScanShred |
| 6 | OpenScanStoreForCollection |
| 7 | Recycle |
| 8 | ReturnToSender |
| 9 | Shred |
| 10 | DepositCheck |
| 11 | Unknown |
## Request Body
### Required Fields
ID of the business linked to this record.
Plan name.
Category of the plan: FullTimePrivateOffice, PartTimePrivateOffice, FullTimeDedicatedDesk, PartTimeDedicatedDesk, FullTimeHotDesk, PartTimeHotDesk, FullTimeOther, PartTimeOther, Storage, VirtualOffice, Virtual, or Other. Defaults to `eTariffType.FullTimePrivateOffice`.
Recurring price charged per billing cycle.
ID of the currency linked to this record.
Number of days' notice required before a contract can be cancelled.
Display order on the members portal (lower numbers appear first).
Billing cycle length in months. Set to 0 if billing by weeks instead.
Billing cycle length in weeks. Set to 0 if billing by months instead.
Strategy for determining when booking charges are due: RenewalDate, BookingEndDate, BookingCreationDate, or NextNthOfMonth. Defaults to `eTariffBookingDueDateStrategy.RenewalDate`.
Provider used for address identity checks: Manual or StripeIdentity. Defaults to `eIdentityCheckProvider.Manual`.
How often to repeat the address identity check: Never, Every3Months, Every6Months, Every12Months, or Every24Months. Defaults to `eIdentityCheckRepeatPattern.Never`.
Provider used for identity checks: Manual or StripeIdentity. Defaults to `eIdentityCheckProvider.Manual`.
How often to repeat the identity check: Never, Every3Months, Every6Months, Every12Months, or Every24Months. Defaults to `eIdentityCheckRepeatPattern.Never`.
Allowed handling preferences for mail deliveries (virtual office).
Allowed handling preferences for parcel deliveries (virtual office).
Allowed handling preferences for check deliveries (virtual office).
Allowed handling preferences for publicity deliveries (virtual office).
Allowed handling preferences for other deliveries (virtual office).
### Optional Fields
Day of the month on which invoices are generated for members on this plan.
Whether the plan is visible to customers on the members portal and mobile app.
Whether this plan is available to any AI channels (Email, Chat or WhatsApp) for recommendations for private offices;.
Custom notes provided to the AI assistant when describing this plan.
Whether to show the plan price to the AI assistant.
Custom price shown to the AI assistant instead of the actual price.
Whether this plan uses time passes for check-in access.
Plan description shown to customers.
Custom text shown on the invoice line instead of the plan name.
One-off fee charged when a customer first signs up to this plan.
Standard tax rate applied to charges on this plan.
Reduced tax rate applied when applicable.
Tax-exempt rate applied when applicable.
Financial account used for revenue tracking.
Terms and conditions text that members must accept when signing up.
URL to upload a new contract document template.
Set to true to remove the uploaded contract document file.
Group name used to visually group plans together on the members portal.
Prevents members from cancelling this plan through the members portal.
Maximum number of members that can be signed up to this plan at any time.
Minimum number of days a contract must be active before it can be cancelled.
Default minimum contract term in months for new sign-ups.
Number of days after contract cancellation before the member account is deactivated.
Maximum number of check-ins included per billing cycle.
Maximum number of check-ins allowed per month.
Maximum number of check-ins allowed per week.
Maximum number of visitor passes allowed per month.
Maximum number of visitor passes allowed per week.
Maximum number of visitor passes allowed per day.
Maximum number of hours included per billing cycle.
Maximum number of hours allowed per month.
Maximum number of hours allowed per week.
Maximum booking minutes allowed per week.
Maximum booking minutes allowed per month.
Discount percentage for extra services.
Discount percentage for time passes.
Discount percentage for charges.
Number of days after which the contract is automatically cancelled if not paid.
Number of billing cycles to invoice in advance.
Day of the month used to align billing cycles when prorating.
Number of days before the prorate day to start prorating.
Whether to prorate the final invoice when a contract is cancelled mid-cycle.
Number of days to extend a contract after payment is received.
Whether to exclude this plan's charges from member invoices.
Whether to automatically generate invoices at the end of each billing cycle.
Raise invoice every N months.
Raise invoice every N weeks.
Minimum total amount charged per billing cycle regardless of usage.
Whether time pass charges count towards the minimum price.
Whether extra service charges count towards the minimum price.
Whether event charges count towards the minimum price.
Whether the plan is archived and no longer available for new sign-ups.
Whether the plan is starred (highlighted) on the members portal.
Whether new sign-ups are kept on hold until manually approved.
Whether members can pause their contract on this plan.
Maximum number of times a contract can be paused per year.
Maximum number of billing cycles a contract can be paused for.
Day of the month used when BookingDueDateStrategy is NextNthOfMonth.
Whether this is a virtual office plan with mail handling features.
Whether to keep the contract on hold until all required identity checks are completed.
Whether to request an address identity check from members signing up to this plan.
Instructions shown to members when completing the address identity check.
Whether to keep the contract paused if the address identity check reveals a mismatch.
Whether to request an identity (ID document) check from members signing up to this plan.
Instructions shown to members when completing the identity check.
Whether to request an AML check from members signing up to this plan.
Whether to enable AML checks against the OpenSanctions dataset.
Whether to enable AML checks against the Pappers dataset.
Which OpenSanctions dataset to check against for AML screening (e.g. 'default').
Score threshold for AML checks, between 0 and 1. Matches with a score above this threshold will be considered a positive match. Default is 0.7.
Whether to email the onboarding form to new members signing up to this plan.
ID of the onboarding form page sent to new members.
Product IDs for mail stored for collection (virtual office).
Product IDs for mail forwarding (virtual office).
Product IDs for mail recycling (virtual office).
Product IDs for mail shredding (virtual office).
Product IDs for mail scanning (virtual office).
Product IDs for returning mail to sender (virtual office).
Product IDs for check deposits (virtual office).
Product IDs for mail collection (virtual office).
Maximum number of days deliveries are stored before being returned (virtual office).
Maximum number of company name aliases allowed for mail handling (virtual office).
Maximum number of mail recipients allowed (virtual office).
Maximum number of forwarding addresses allowed (virtual office).
Whether to automatically transfer mail handling products to the member's contract.
## Code Examples
```bash cURL theme={null}
curl -X POST \
"https://spaces.nexudus.com/api/billing/tariffs" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"BusinessId": 0,
"Name": "",
"SystemTariffType": 0,
"Price": 0,
"CurrencyId": 0,
"CancellationPeriod": 0,
"DisplayOrder": 0,
"InvoiceEvery": 0,
"InvoiceEveryWeeks": 0,
"BookingDueDateStrategy": 0,
"AddressIdentityCheckProvider": 0,
"AddressIdentityCheckRepeatPattern": 0,
"IdentityCheckProvider": 0,
"IdentityCheckRepeatPattern": 0,
"DeliveryPreferencesMail": 0,
"DeliveryPreferencesParcels": 0,
"DeliveryPreferencesChecks": 0,
"DeliveryPreferencesPublicity": 0,
"DeliveryPreferencesOther": 0
}'
```
```javascript JavaScript theme={null}
const response = await fetch(
'https://spaces.nexudus.com/api/billing/tariffs',
{
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_TOKEN',
'Content-Type': 'application/json'
},
body: JSON.stringify({
BusinessId: 0,
Name: '',
SystemTariffType: 0,
Price: 0,
CurrencyId: 0,
CancellationPeriod: 0,
DisplayOrder: 0,
InvoiceEvery: 0,
InvoiceEveryWeeks: 0,
BookingDueDateStrategy: 0,
AddressIdentityCheckProvider: 0,
AddressIdentityCheckRepeatPattern: 0,
IdentityCheckProvider: 0,
IdentityCheckRepeatPattern: 0,
DeliveryPreferencesMail: 0,
DeliveryPreferencesParcels: 0,
DeliveryPreferencesChecks: 0,
DeliveryPreferencesPublicity: 0,
DeliveryPreferencesOther: 0
})
}
);
const data = await response.json();
```
```python Python theme={null}
import requests
response = requests.post(
'https://spaces.nexudus.com/api/billing/tariffs',
headers={
'Authorization': 'Bearer YOUR_TOKEN',
'Content-Type': 'application/json'
},
json={
'BusinessId': 0,
'Name': '',
'SystemTariffType': 0,
'Price': 0,
'CurrencyId': 0,
'CancellationPeriod': 0,
'DisplayOrder': 0,
'InvoiceEvery': 0,
'InvoiceEveryWeeks': 0,
'BookingDueDateStrategy': 0,
'AddressIdentityCheckProvider': 0,
'AddressIdentityCheckRepeatPattern': 0,
'IdentityCheckProvider': 0,
'IdentityCheckRepeatPattern': 0,
'DeliveryPreferencesMail': 0,
'DeliveryPreferencesParcels': 0,
'DeliveryPreferencesChecks': 0,
'DeliveryPreferencesPublicity': 0,
'DeliveryPreferencesOther': 0
}
)
data = response.json()
```
## Response
### 200
HTTP status code. `200` on success.
A human-readable message confirming the creation.
Contains the `Id` of the newly created record.
`true` if the tariff was created successfully.
`null` on success.
```json Example Response theme={null}
{
"Status": 200,
"Message": "Tariff was successfully created.",
"Value": {
"Id": 87654321
},
"OpenInDialog": false,
"OpenInWindow": false,
"RedirectURL": null,
"JavaScript": null,
"UpdatedOn": "2025-01-15T10:30:00Z",
"UpdatedBy": "admin@example.com",
"Errors": null,
"WasSuccessful": true
}
```
### 400
A summary of the validation error(s), in the format `PropertyName: error message`.
`null` on validation failure.
Array of validation errors.
The value that was submitted for the field, or `null` if missing.
The validation error message.
The name of the property that failed validation.
`false` when the request fails validation.
```json Example Response theme={null}
{
"Message": "Name: is a required field",
"Value": null,
"Errors": [
{
"AttemptedValue": null,
"Message": "is a required field",
"PropertyName": "Name"
}
],
"WasSuccessful": false
}
```