# Return kit conponents via API

**URL:** <https://community.shiphero.com/t/return-kit-conponents-via-api/3700>\
**Category:** GraphQL API\
**Created:** [June 5, 2026, 1:47pm UTC](https://community.shiphero.com/t/return-kit-conponents-via-api/3700 "2026-06-05T13:47:00Z")\
**Posts on this page:** 7\
**Page:** 1

<div class="post-metadata">

**Author:** ![mendyshipfrankly](https://avatars.discourse-cdn.com/v4/letter/m/8797f3/32.png) [@mendyshipfrankly](https://community.shiphero.com/u/mendyshipfrankly)\
**Post date:** [June 5, 2026, 1:47pm UTC](https://community.shiphero.com/t/return-kit-conponents-via-api/3700/1 "2026-06-05T13:47:00Z")

</div>

Can I create a return on a regular kit sku but only for one of the components via API?

---

<div class="post-metadata">

**Author:** ![jjconti](https://avatars.discourse-cdn.com/v4/letter/j/bcef8e/32.png) [@jjconti](https://community.shiphero.com/u/jjconti)\
**Post date:** [June 25, 2026, 7:22pm UTC](https://community.shiphero.com/t/return-kit-conponents-via-api/3700/2 "2026-06-25T19:22:02Z")

</div>

Yes, you should be able to create the return against the component SKU by passing the component as the return line item and setting `is_component: true`.

Example shape:

```auto
mutation {
  return_create(data: {
    order_id: "ORDER_ID",
    warehouse_id: "WAREHOUSE_ID",
    return_reason: "Customer return",
    line_items: [
      {
        sku: "COMPONENT_SKU",
        quantity: 1,
        return_reason: "Customer return",
        condition: "Good",
        is_component: true
      }
    ]
  }) {
    request_id
    return {
      id
      legacy_id
      status
    }
  }
}

```

The important part is that the `sku` should be the component SKU, not the parent kit SKU, and `is_component` should be set to `true`.

I haven’t tested this against your account specifically, so if you still get a validation error, please share the exact error and whether the original order line item was shipped as the kit parent or exploded into components.

Additionally, there is a new field in your user profile in this forum where you can complete your ShipHero account ID. With that info I can give you a more accurate response.

---

<div class="post-metadata">

**Author:** ![mendyshipfrankly](https://avatars.discourse-cdn.com/v4/letter/m/8797f3/32.png) [@mendyshipfrankly](https://community.shiphero.com/u/mendyshipfrankly)\
**Post date:** [June 25, 2026, 7:56pm UTC](https://community.shiphero.com/t/return-kit-conponents-via-api/3700/3 "2026-06-25T19:56:37Z")

</div>

{

**“body”** : {

**“errors”** : [

{

**“message”** : “No line item with sku ‘secri2’ exists for order ‘841957994’”,

**“operation”** : “return\_create”,

**“field”** : “return\_create”,

**“request\_id”** : “6a3d8719673ac62ffbc30398”,

**“code”** : 5

}

],

**“data”** : {

**“return\_create”** : null

},

**“extensions”** : {

**“throttling”** : {

**“estimated\_complexity”** : 10,

**“cost”** : 10,

**“cost\_detail”** : {

**“return\_create”** : {

**“items\_count”** : 0,

**“cost”** : 10,

**“total\_cost”** : 10,

**“fields”** : {}

}

},

**“user\_quota”** : {

**“credits\_remaining”** : 3994,

**“max\_available”** : 4004,

**“increment\_rate”** : 60

}

}

}

}

---

<div class="post-metadata">

**Author:** ![jjconti](https://avatars.discourse-cdn.com/v4/letter/j/bcef8e/32.png) [@jjconti](https://community.shiphero.com/u/jjconti)\
**Post date:** [June 25, 2026, 9:19pm UTC](https://community.shiphero.com/t/return-kit-conponents-via-api/3700/4 "2026-06-25T21:19:19Z")

</div>

Seems this kit is a regular kit. Can you try with a build kit?

Anyway I’m opening a ticket for the bug, you should be able to return regular kit items too.

---

<div class="post-metadata">

**Author:** ![mendyshipfrankly](https://avatars.discourse-cdn.com/v4/letter/m/8797f3/32.png) [@mendyshipfrankly](https://community.shiphero.com/u/mendyshipfrankly)\
**Post date:** [June 25, 2026, 9:49pm UTC](https://community.shiphero.com/t/return-kit-conponents-via-api/3700/5 "2026-06-25T21:49:49Z")

</div>

previously I had success with build kits

---

<div class="post-metadata">

**Author:** ![jjconti](https://avatars.discourse-cdn.com/v4/letter/j/bcef8e/32.png) [@jjconti](https://community.shiphero.com/u/jjconti)\
**Post date:** [June 26, 2026, 12:29pm UTC](https://community.shiphero.com/t/return-kit-conponents-via-api/3700/6 "2026-06-26T12:29:48Z")

</div>

Ok, a ticket was open to fix this bugs.

---

<div class="post-metadata">

**Author:** ![mendyshipfrankly](https://avatars.discourse-cdn.com/v4/letter/m/8797f3/32.png) [@mendyshipfrankly](https://community.shiphero.com/u/mendyshipfrankly)\
**Post date:** [September 3, 2026, 7:49pm UTC](https://community.shiphero.com/t/return-kit-conponents-via-api/3700/7 "2026-09-03T19:49:46Z")

</div>

Is there an update on this?