import { Autumn } from 'autumn-js'
const autumn = new Autumn()
const result = await autumn.features.create({
name: "API Calls",
type: "metered",
consumable: true,
featureId: "api-calls",
});from autumn_sdk import Autumn
autumn = Autumn(secret_key="am_sk_test...")
res = autumn.features.create(
name="API Calls",
type_="metered",
feature_id="api-calls",
consumable=True,
)curl --request POST \
--url https://api.useautumn.com/v1/features.create \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'x-api-version: <x-api-version>' \
--data '
{
"feature_id": "api-calls",
"name": "API Calls",
"type": "metered",
"consumable": true
}
'{
"id": "api-calls",
"name": "API Calls",
"type": "metered",
"consumable": true,
"archived": false,
"display": {
"singular": "API call",
"plural": "API calls"
}
}
Create Feature
Creates a new feature.
Use this to programmatically create features for metering usage, managing access, or building credit systems.
import { Autumn } from 'autumn-js'
const autumn = new Autumn()
const result = await autumn.features.create({
name: "API Calls",
type: "metered",
consumable: true,
featureId: "api-calls",
});from autumn_sdk import Autumn
autumn = Autumn(secret_key="am_sk_test...")
res = autumn.features.create(
name="API Calls",
type_="metered",
feature_id="api-calls",
consumable=True,
)curl --request POST \
--url https://api.useautumn.com/v1/features.create \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'x-api-version: <x-api-version>' \
--data '
{
"feature_id": "api-calls",
"name": "API Calls",
"type": "metered",
"consumable": true
}
'{
"id": "api-calls",
"name": "API Calls",
"type": "metered",
"consumable": true,
"archived": false,
"display": {
"singular": "API call",
"plural": "API calls"
}
}
Body Parameters
Response
{
"id": "api-calls",
"name": "API Calls",
"type": "metered",
"consumable": true,
"archived": false,
"display": {
"singular": "API call",
"plural": "API calls"
}
}
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Body
The name of the feature.
The type of the feature. 'single_use' features are consumed, like API calls, tokens, or messages. 'continuous_use' features are allocated, like seats, workspaces, or projects. 'credit_system' features are schemas that unify multiple 'single_use' features into a single credit system.
boolean, metered, credit_system, ai_credit_system The ID of the feature to create.
Whether this feature is consumable. A consumable feature is one that periodically resets and is consumed rather than allocated (like credits, API requests, etc.). Applicable only for 'metered' features.
How grants of this feature from several plans combine. 'sum' (default) adds them up. 'max' or 'min' keeps only the highest or lowest grant among plan items with no price; priced items always add on top. Metered and credit system features only.
sum, max, min Singular and plural display names for the feature in your user interface.
Show child attributes
Show child attributes
A schema that maps metered feature IDs to flat or graduated credit costs. For classic credit systems only — AI credit systems use model_markups instead.
- Option 1
- Option 2
Show child attributes
Show child attributes
Per-model markup overrides for AI credit systems. Maps model IDs to their markup configuration.
Show child attributes
Show child attributes
Default percentage markup for this AI credit system. Used when no model or provider markup applies. Use -100 to make usage free.
x >= -100Per-provider default markup percentages for AI credit systems. Provider keys match the first segment of model_id.
Show child attributes
Show child attributes
Response
OK
The unique identifier for this feature, used in /check and /track calls.
Human-readable name displayed in the dashboard and billing UI.
Feature type: 'boolean' for on/off access, 'metered' for usage-tracked features, 'credit_system' for unified credit pools, 'ai_credit_system' for model-based token pricing.
boolean, metered, credit_system, ai_credit_system For metered features: true if usage resets periodically (API calls, credits), false if allocated persistently (seats, storage).
Whether the feature is archived and hidden from the dashboard.
How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
sum, max, min Event names that trigger this feature's balance. Allows multiple features to respond to a single event.
For classic credit systems: maps metered features to flat or graduated credit costs.
- Option 1
- Option 2
- Option 3
Show child attributes
Show child attributes
Per-model markup overrides for AI credit systems.
Show child attributes
Show child attributes
Default percentage markup for AI credit systems. Use -100 to make usage free.
x >= -100Per-provider default markup percentages for AI credit systems.
Show child attributes
Show child attributes
Display names for the feature in billing UI and customer-facing components.
Show child attributes
Show child attributes
Processor mappings for this feature. Present when a Stripe product or meter is set.
Show child attributes
Show child attributes