Articles in this section
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

Repeater Field Items to a Voxel Workflow


🗂️ 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 and repeaterData 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: **

Iterator Configuration

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.

Iterator Step Response


🧱 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}}

Repeater fields mapping


🧪 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" }
  ]
}

Voxel add repeater field item response

  • 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.

after workflow execution.png


🔍 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
Was this article useful?
Like
Dislike
Help us improve this page
Please provide feedback or comments
Access denied
Access denied