---
title: "Create a Feature"
method: POST
path: "/features"
tags: ["featureLibraries"]
---

# Create a Feature

`POST /features`

## Request

- Base URL: `https://{tenant_name}.benchling.com/api/v2`
- URL: `https://{tenant_name}.benchling.com/api/v2/features`
- Auth: HTTP bearer

Create a Feature

## Request body

- FeatureCreate: Inputs for a new feature
  - `color` string: The color of the annotations generated by the feature. Must be a valid hex string
  - `featureLibraryId` string: The id of the feature library the feature belongs to
  - `featureType` string, nullable: The type of feature, like gene, promoter, etc. Note: This is an arbitrary string, not an enum
  - `name` string: The name of the feature
  - `pattern` string: The pattern used for matching during auto-annotation.
  - `matchType` 'nucleotide' | 'protein': The match type of the feature. Used to determine how auto-annotate matches are made.

## Response `201`

Created

- Feature: A feature from a feature library
  - `color` string: The color of the annotations generated by the feature. Must be a valid hex string
  - `featureLibraryId` string: The id of the feature library the feature belongs to
  - `featureType` string, nullable: The type of feature, like gene, promoter, etc. Note: This is an arbitrary string, not an enum
  - `name` string: The name of the feature
  - `pattern` string: The pattern used for matching during auto-annotation.
  - `id` string: The id of the feature
  - `matchType` 'nucleotide' | 'protein': The match type of the feature. Used to determine how auto-annotate matches are made.

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/benchling/apis/benchling-api-2.md) - [All operations](https://skmtc.dev/benchling/apis/benchling-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/benchling/apis/benchling-api-2/revisions/01d2fa8523cd?raw)