---
title: "Instagram API Error 100: Carousel Validation Failed & How to Fix It"
description: "Instagram carousel posts failing with Error 100 or invalid_children? See why nested container validation fails and how Ayrshare handles it automatically today."
canonical: https://www.ayrshare.com/solutions/instagram-api-error-100-carousel-validation-failed-how-to-fix-it/
lastModified: 2026-07-09
pageType: solution
---

# Instagram API Error 100: Carousel Validation Failed & How to Fix It

> Instagram carousel posts failing with Error 100 or invalid_children? See why nested container validation fails and how Ayrshare handles it automatically today.

## Instagram API Error 100: Carousel Validation Failed & How to Fix It

[Start free trial](https://app.ayrshare.com)
[View pricing](/pricing/)

We've all stared at this particular failure in our logs. You want to post a slick, 4-image carousel for your users. You send what looks like a perfectly formatted payload to Meta's Graph API, fully expecting a success response. Instead, you get slapped with an HTTP 400 containing OAuthException Code 100, or a deeply unhelpful Instagram carousel API error screaming about `invalid_children` or an unknown container ID.

Your images are hosted correctly, and your auth tokens are fresh. You've just tripped over Meta's convoluted nested container architecture.

## The "Why" Behind the Validation Failure

When you want to publish a single image to Instagram, it's a two-step process: create a media container, then publish it. But when you want to publish a carousel, the Graph API introduces a complex, multi-stage orchestration sequence. You cannot simply pass a flat JSON Array of image URLs.

The API requires you to manually build a nested state machine:

- **Child Containers:** You must first hit the API to create an individual "Item Container" for every single image or video in your carousel, explicitly flagging them with `is_carousel_item: true`.
- **The Parent Container:** Once you have the ID for every child, you must create a master "Carousel Container," passing the child IDs in the exact Image Order you want them to appear.
- **The Publish Execution:** Finally, you publish the master container.

The Validation rules here are brutal. If you mix aspect ratios (e.g., combining a 1:1 square with a 4:5 portrait), the parent container creation will fail. If you exceed the strict 10-media-item limit, it fails. Most frustratingly, if you attempt to create the parent container before Meta's servers have completely finished asynchronously processing the child containers, the API will reject your request with an `invalid_children` error.

For more detail, see [Instagram media guidelines](/docs/media-guidelines/instagram).

## The Manual Fix: Container Orchestration & Polling

To solve this natively, your backend must intercept the carousel request, loop through the images to create child containers, gracefully await their processing, and then stitch them together.

Here is a Node.js implementation using axios that successfully maps an array of URLs into a compliant Instagram carousel payload.

```javascript
const axios = require("axios");

async function publishInstagramCarousel(igUserId, accessToken, imageUrls, caption) {
  if (imageUrls.length > 10) throw new Error("Validation Failed: Max 10 images allowed.");

  try {
    // 1. Create a child container for each image in parallel (maintaining Image Order)
    const childContainerPromises = imageUrls.map(url =>
      axios.post(`https://graph.facebook.com/v19.0/${igUserId}/media`, null, {
        params: {
          image_url: url,
          is_carousel_item: true, // Crucial flag for carousel children
          access_token: accessToken
        }
      })
    );

    const childResponses = await Promise.all(childContainerPromises);
    const childrenIds = childResponses.map(res => res.data.id);

    // 2. Create the Parent Carousel Container using the ordered JSON Array of IDs
    const parentResponse = await axios.post(`https://graph.facebook.com/v19.0/${igUserId}/media`, null, {
      params: {
        caption: caption,
        media_type: "CAROUSEL",
        children: childrenIds.join(","), // Meta expects a comma-separated string of IDs
        access_token: accessToken
      }
    });

    const carouselContainerId = parentResponse.data.id;

    // 3. Publish the completed Carousel
    const publishResponse = await axios.post(`https://graph.facebook.com/v19.0/${igUserId}/media_publish`, null, {
      params: {
        creation_id: carouselContainerId,
        access_token: accessToken
      }
    });

    return publishResponse.data;
  } catch (error) {
    console.error("Instagram carousel API error:", error.response?.data || error.message);
    throw error;
  }
}
```

## The Pivot: Stop Building Nested State Machines

Writing asynchronous maps, joining comma-separated ID strings, and babysitting container states just to upload a few JPEGs is a massive drain on your engineering resources. You want a reliable post carousel API, not a distributed media orchestrator.

This is where our team at Ayrshare steps in. Think of us as your API insurance policy. When you use Ayrshare's abstraction layer, we handle the multi-stage containerization natively. You don't need to track child IDs, manage strict aspect ratio validations, or worry about async timing failures.

You pass us a clean array of URLs, and we seamlessly handle the orchestration, order mapping, and error handling behind the scenes.

## The Comparison: Native vs. Ayrshare

Here is how your codebase transforms when you stop writing custom container middleware and offload the complexity to us.

### Before (Native Meta Graph API)

```javascript
// You are responsible for the 3-step nested container logic and strict ID mapping.
const childIds = await createCarouselChildren(imageUrls);
const parentId = await createCarouselParent(childIds, "Check out these photos!");
const response = await publishContainer(parentId);

// If an image has the wrong aspect ratio, it fails here and orphans the other containers.
```

### After (Ayrshare API)

```javascript
// We handle the child containers, the parent linking, and the publishing flow.
const ayrshare = require("ayrshare")("YOUR_AYRSHARE_API_KEY");

const response = await ayrshare.post({
  post: "Check out these photos!",
  platforms: ["instagram"],
  mediaUrls: [
    "https://example.com/image1.jpg",
    "https://example.com/image2.jpg",
    "https://example.com/image3.jpg"
  ], // Just pass the array. We maintain the Image Order.
  profileKeys: ["client_profile_key"]
});

// Done. No Promise.all(), no child containers, no Error 100s.
```

For more detail, see [Instagram API documentation](/docs/apis/post/social-networks/instagram).

For more detail, see [Instagram API Error 100 (Media ID Not Found)](/solutions/how-to-fix-instagram-api-error-100-media-id-not-found-and-unknown-error/).

For more detail, see [Instagram Graph API Error 9 (daily post limit)](/solutions/instagram-graph-api-error-9-the-25-post-daily-limit-how-to-fix-it/).

## Instagram Carousel Error 100: FAQs

### How does Ayrshare simplify Instagram carousel posting?

Ayrshare handles the full multi-stage container orchestration for a carousel post: creating each child container, linking them to a parent container in order, and publishing, all from a single mediaUrls array in one API call.
### Why does the Instagram Carousel API reject a request with invalid_children?

Ayrshare's engineering team traces most invalid_children errors to the parent container being created before Meta's servers finish asynchronously processing every child container; sending the parent request too early is the most common cause.
### Does Ayrshare enforce Instagram's 10-image carousel limit automatically?

Ayrshare validates the item count before submission, matching Instagram's own hard cap of 10 media items per carousel, so a request that would fail at Meta's servers is caught earlier instead.
### Can a carousel mix square and portrait images without triggering Error 100?

No, mixing aspect ratios like 1:1 and 4:5 within the same carousel is Instagram's own restriction, not something any integration can bypass; Ayrshare flags mismatched images before they reach the parent container step.

## Ship Social Features in Days, Not Quarters

Start your 28-day free trial, or talk with our team about pricing for thousands of profiles.

[Start free trial](https://app.ayrshare.com)
[Talk to sales](/contact/)