Category / Section
How to Add Multiple Repeater Field Items to a Voxel Post using FlowMattic
4 mins read
Updated:
With FlowMattic’s powerful automation builder, you can easily loop through a JSON array of repeater field data and dynamically add each item to a Voxel post’s Repeater Field—all in one workflow. This eliminates the need to manually add items one by one.
This guide will walk you through how to set it up step by step, using:
- Webhooks to receive data
- Iterator to loop through each repeater item
- Voxel integration to add the item to the selected post
🗂️ What You’ll Need
- A Voxel-powered WordPress site
- A Repeater Field configured for a post type in Voxel
- FlowMattic installed and connected
- A JSON payload like the following:
{
"post_id": "32354",
"repeaterData": [
{ "firstName": "Valeria", "status": "Waiting" },
{ "firstName": "Shelby", "status": "In-progress" }
]
}
🔗 Step 1: Capture Webhook with JSON Array Input
1.1 Add Webhook Trigger
- In your FlowMattic workflow, select “Webhooks by FlowMattic” as the trigger.
- Choose “Capture Webhook Response”.
1.2 Enable Simple Response
- When configuring the webhook, enable the “Simple Response” toggle.
- This makes sure the JSON array (
repeaterData
) is not deeply nested and can be directly passed to the Iterator step.
1.3 Test the Webhook
- Send a test request to the webhook URL using Postman, Curl, or your app.
- Sample Payload:
{
"post_id": "32354",
"repeaterData": [
{ "firstName": "Valeria", "status": "Waiting" },
{ "firstName": "Shelby", "status": "In-progress" }
]
}
- You should now see the
post_id
andrepeaterData
inside the webhook response panel.
🔁 Step 2: Use Iterator to Loop Through Repeater Data
2.1 Add Iterator Module
- Add a new step in your workflow and choose the Iterator by FlowMattic module.
- This module loops through each item in a JSON array, allowing you to process them individually.
2.2 Configure Iterator
-
In the “Iteration Array” field, select
repeaterData
from the captured webhook response. -
This tells FlowMattic to loop through every object inside the array.
-
firstName
-
status
-
…and other fields if required.
**Example: **
2.3 Test the Iterator
- Click Next until you reach the Test tab.
- Click Test Action to simulate the first item in the loop.
- This will generate a sample item that will be used to configure future steps.
🧱 Step 3: Add Voxel - Add Repeater Field Item Action
3.1 Add Voxel Step
- Add a new step in the workflow and select Voxel as the app.
- Choose the action “Add Repeater Field Item”.
3.2 Configure Voxel Action
Post ID
- In the Post ID field, select the value from the Webhook response:
{{webhook1.post_id}}
Post Type
- Choose the appropriate Post Type in which the repeater field is registered.
Repeater Fields Mapping
- Once the Post Type is selected, the Repeater Fields panel will auto-populate.
- Map each field using the values from the Iterator step:
Repeater Field Label | Map From Iterator |
---|---|
Field Item: Name |
{{iterator2.firstName}} |
Field Item: Status |
{{iterator2.status}} |
🧪 Step 4: Test Voxel Action
- Click Continue to move to the Test tab.
- Click Test Action.
You should receive a successful response:
{
"success": true,
"message": "Repeater field item added successfully",
"post_id": 32354,
"repeater": [
{ "name": "Valeria", "status": "Waiting" }
]
}
- This confirms the mapping and Voxel repeater insertion is working for a single item.
✅ Step 5: Make the Workflow Live & Run Full Test
5.1 Save and Close
- Click Save & Close on the Voxel step.
5.2 Make the Workflow Live
- Use the toggle to turn ON your workflow in FlowMattic.
5.3 Send the Full JSON Test
- Resend the full payload with multiple array items to the webhook.
- This time, the Iterator will loop through all array items and the Voxel step will be executed once per item.
🔍 How It Works Under the Hood
- The Webhook step captures structured JSON data from any source—frontend form, Zapier, third-party service, etc.
- The Iterator processes each item in the array sequentially.
- The Voxel action uses the post ID and inserts one item at a time into the repeater field.
- Since this runs in automation, no manual post editing is required.
📝 Pro Tips
- You can include more fields in each repeater item, like
icon
,url
,role
, etc.—just ensure they are present in the JSON and mapped in the Voxel step. - Want to add repeater items after creating a post in the same workflow? Just add a “Create Post” action before this and map the returned
post_id
. - Add conditional logic if you want to limit which items should be inserted based on their values (e.g., status = active).
📌 Summary
Component | Role |
---|---|
Webhook | Captures incoming JSON with post_id and repeaterData array |
Iterator | Loops through each item in repeaterData |
Voxel Action | Inserts one item into the Repeater Field per iteration |