# Create Collection Item

Create new items within a Collection using the Write API. Collections support completely dynamic schemas and multi-locale content, making them ideal for flexible content types like team members, products, or testimonials.

Dynamic Schema Flexibility: Collection fields are entirely user-defined through your dashboard configuration. The field structure in your request must match the schema you've configured for the specific collection, including field types, validation rules, and any required fields.

Locale Structure: For organizations without locales configured, provide field values directly in a flat structure. For multi-locale organizations, nest your field data under the appropriate locale codes (e.g., "en", "es") to create content in multiple languages simultaneously.

Media Integration: If Media is the field_type for a chosen field, any URL can be provided as the field's value. The media corresponding to this URL will be automatically downloaded and uploaded to your ButterCMS media library, ensuring reliable hosting and CDN integration.

Asynchronous Processing: This endpoint returns 202 Accepted immediately to ensure fast response times for your application. The actual item creation, including media uploads, validation, and any configured webhooks, happens in the background processing queue.
See also: Architecture & Performance for guidance on levels, pagination, and performance best practices.

Endpoint: POST /content/
Version: 2.0.0
Security: writeTokenAuth

## Request fields (application/json):

  - `key` (string, required)
    The unique identifier/slug of the Collection to create an item in.

Must match an existing collection in your organization.
    Example: "team_members"

  - `status` (string)
    Status of the collection item:

- draft: Item is saved but not publicly available
- published: Item is live and publicly accessible

Defaults to "draft" if not specified.
    Enum: "published", "draft"

  - `fields` (array, required)
    Array of collection item data. Structure varies based on locale configuration:

- Without Locales: Array of objects with direct field key-value pairs
- With Locales: Array of objects with locale codes as keys, containing field data

Dynamic Nature: Field names and types are defined by your collection schema and can vary completely between collections.
    Example: [{"name":"John Smith","position":"Senior Developer","email":"john@company.com"}]

## Response 202 fields (application/json):

  - `status` (string)
    Indicates that the collection item creation is being processed asynchronously
    Enum: "pending"

## Response 401 fields (application/json):

  - `detail` (string)
    Error message describing what went wrong
    Example: "Authentication credentials were not provided"