Craft Documents icon

Craft Documents

Interact with Craft Multi-Document API - manage documents, blocks, collections, and search

Actions14

Collection → Add Items

AI-generated

Summary

Add one or more new items to a specified collection in a Craft document.

Inputs

  • Collection Name or ID (required) — Select a collection from your documents by choosing from the list or specifying its ID using an expression.
  • Items (required) — Provide one or more items to add, each with a required title and optional additional properties as a JSON object, where the schema depends on the collection.
  • Allow New Select Options — Optionally allow creating new options for select-type properties if they don't exist in the collection schema (use with caution).

Output shape

a single response object from the API call, containing the result of adding items to the collection

The operation sends a POST request to /collections/{collectionId}/items with the items array in the body. No explicit pagination applies. The exact response depends on the Craft API and is returned as is. Errors are surfaced if the request fails.

Examples

Example 1: To add new data entries into a database-like collection within a Craft document using multiple item titles and properties.

Set 'Collection Name or ID' to target the desired collection, add one or more items specifying titles and optionally properties as JSON, and execute the operation to create those items in the collection.

Links

Discussion