Skip to content
WActionWeaviateUpdated May 2026

How do I insert an object into a Weaviate collection?

Short answer: Drop the "WeaviateInsert Object" action anywhere in your workflow, map the inputs from upstream nodes, and publish.

Inputs

The fields this action accepts.

Every field can be mapped from an upstream trigger, AI step, table row, or hard-coded literal.

FieldTypeRequiredDescription
Collection
collection
stringRequiredDocument
Properties
properties
objectRequiredObject data. Keys must match schema.
Vector (optional)
vector
arrayOptionalPrecomputed embedding. Skip to let Weaviate's vectorizer compute it.
UUID (optional)
id
stringOptionalCustom UUID. Weaviate auto-generates if omitted.
Sample request
{
"collection": "Document",
"properties": "{ \"content\": \"...\", \"source\": \"doc.pdf\" }",
"vector": "{{trigger.vector}}",
"id": "{{trigger.id}}"
}
Returns
{
"id": "abc-123-def-456",
"class": "Document",
"properties": {
"content": "..."
}
}

Use these fields in downstream nodes for routing, logging, or error handling.

Triggered by

Apps that pair well as the trigger for Insert Object.

Any of these apps can fire this action as part of a workflow.

FAQ

Questions about Insert Object.

What does the Insert Object action do in Weaviate?
Inserts a single object into a Weaviate collection. Weaviate auto-embeds the text properties via the collection's configured vectorizer (e.g. text2vec-openai), or you can pass a precomputed vector array.
What inputs does Insert Object require?
Required: Collection, Properties. Every input accepts a static value or a variable from any upstream node in your workflow.
Can I use dynamic inputs from earlier workflow nodes?
Yes. Any field on this action can pull values from upstream nodes, whether that's a form response, a trigger payload, an AI output, or a lookup result.
What happens if Weaviate returns an error?
The workflow pauses on the failed node, the error message is captured in the run log, and you can retry the run with one click. Auto-retry policies are configurable per workflow with exponential backoff up to 5 attempts.
Does Insert Object support batch operations?
Yes. Run Insert Object inside a Loop node to process arrays. Tiny Command handles Weaviate's rate limits automatically so you don't have to throttle manually.
More actions

Other Weaviate actions.

Send insert object from your workflows.

Triggered by anything in the catalog. Free tier available. No credit card.