Create Collection Field

POST /collections/{collection_id}/fields

Copy endpoint

https://api.webflow.com/v2

Create a custom field in a collection.

Field validation is currently not available through the API.

Bulk creation of fields is not supported with this endpoint. To add multiple fields at once, include them when you create the collection.

Required scope | cms:write

Parameters

path Path Parameters

Name	Type
`collection_id` required Unique identifier for a Collection	string

Request Body

application/json required

The field to create

{
id?: string;
isEditable?: boolean;
isRequired?: boolean;
type: "Color" | "DateTime" | "Email" | "File" | "Image" | "Link" | "MultiImage" | "Number" | "Phone" | "PlainText" | "RichText" | "Switch" | "VideoLink";
displayName: string;
helpText?: string;
} | {
id?: string;
isEditable?: boolean;
isRequired?: boolean;
type: "Option";
displayName: string;
helpText?: string;
metadata: { options: { name: string;id?: string; }[]; };
} | {
id?: string;
isEditable?: boolean;
isRequired?: boolean;
type: "MultiReference" | "Reference";
displayName: string;
helpText?: string;
metadata: { collectionId: string; };
}

Responses

200 application/json

Request was successful

Client Errors

400 application/json

Request body was incorrectly formatted.

{
code?: "bad_request" | "collection_not_found" | "conflict" | "duplicate_collection" | "duplicate_user_email" | "ecommerce_not_enabled" | "forbidden" | "forms_require_republish" | "incompatible_webhook_filter" | "internal_error" | "invalid_auth_version" | "invalid_credentials" | "invalid_domain" | "invalid_user_email" | "item_not_found" | "missing_scopes" | "no_domains" | "not_authorized" | "not_enterprise_plan_site" | "not_enterprise_plan_workspace" | "order_not_found" | "resource_not_found" | "too_many_requests" | "unsupported_version" | "unsupported_webhook_trigger_type" | "user_limit_reached" | "user_not_found" | "users_not_enabled" | "validation_error";
message?: string;
externalReference?: string;
details?: unknown[];
}

401 application/json

Provided access token is invalid or does not have access to requested resource

404 application/json

Requested resource not found

409 application/json

Collection already exists

429 application/json

The rate limit of the provided access_token has been reached. Please have your application respect the X-RateLimit-Remaining header we include on API responses.

Server Errors

500 application/json

We had a problem with our server. Try again later.