# Add an amenity the taxonomy does not have

`POST /lodging/custom-amenities` · Rivier · bookings

Add an amenity the taxonomy does not have.

- Scope: bookings:admin
- Mcp: rivier_lodging_custom_amenity_create
- Sdk: bookings.customAmenity.create
- Cli: bookings custom amenity create

## Request body

`application/json`

```json
{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "enum": [
        "room",
        "bathroom",
        "kitchen",
        "entertainment",
        "climate",
        "safety",
        "accessibility",
        "outdoor",
        "services",
        "family",
        "wellness",
        "business",
        "view",
        "sustainability"
      ]
    },
    "icon": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,40}$",
      "default": "Sparkles"
    },
    "labels": {
      "type": "object",
      "additionalProperties": {
        "type": "string",
        "minLength": 1,
        "maxLength": 80
      },
      "propertyNames": {
        "pattern": "^[a-z]{2,3}(-[A-Za-z0-9]{2,8})?$"
      }
    }
  },
  "required": [
    "category",
    "labels"
  ],
  "additionalProperties": false
}
```

## Responses

- `201`: Success
- `400`: The request was malformed
- `401`: No valid credential
- `403`: The credential lacks the scope, origin or address
- `429`: Over the key's rate limit; see Retry-After

## Example

```sh
curl -X POST 'https://api.rivier.ai/lodging/custom-amenities' \
  -H 'Authorization: Bearer $KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "category": "room",
  "labels": {}
}'
```