Create a feature

This endpoint creates a new feature representing an entitlement component of your application.

POST /features

Create a feature

cURL

curl --request POST \
  --url https://api.getlago.com/api/v1/features \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "feature": {
    "code": "seats",
    "name": "Number of seats",
    "description": "Number of users of the account",
    "privileges": [
      {
        "code": "max",
        "name": "Maximum",
        "value_type": "integer"
      },
      {
        "code": "max_admins",
        "name": "Max Admins",
        "value_type": "integer"
      },
      {
        "code": "root",
        "name": "Allow root user",
        "value_type": "boolean"
      },
      {
        "code": "provider",
        "name": "SSO Provider",
        "value_type": "select",
        "config": {
          "select_options": [
            "google",
            "okta"
          ]
        }
      }
    ]
  }
}
'

200

{
  "feature": {
    "code": "seats",
    "name": "Number of seats",
    "description": "Number of users of the account",
    "privileges": [
      {
        "code": "max",
        "name": "Maximum",
        "value_type": "integer",
        "config": {}
      },
      {
        "code": "max_admins",
        "name": "Max Admins",
        "value_type": "integer",
        "config": {}
      },
      {
        "code": "root",
        "name": "Allow root user",
        "value_type": "boolean",
        "config": {}
      },
      {
        "code": "provider",
        "name": "SSO Provider",
        "value_type": "select",
        "config": {
          "select_options": [
            "google",
            "okta"
          ]
        }
      }
    ],
    "created_at": "2025-07-17T12:34:35Z"
  }
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Feature payload

feature · object · required

Show child attributes

Response

200

application/json

Feature created

feature · object · required

Show child attributes