Build Child Products

This endpoint builds your child/variation products. Once you have a base product and have attached some variations, this endpoint will trigger the process that applies those variations to the base product. The result will be a list of child products that each have one combination of the variation options applied to it. The id you should use in the url is that of the base product.

POST Build Child Products

https://api.moltin.com/v2/products/:id/build

Request

Response

Path Parameters:

Name	Required	Type	Description
id	Required	string	ID of the base product to be built

Headers:

Name	Required	Type	Description
X-Moltin-Currency	Optional	string	ISO code of the required currency
Authorization	Required	string	The Bearer token to grant access to the API

200 OK

{
    "type": "product",
    "id": "d8e64f88-7bb4-4095-a7e8-a55d094648bb",
    "name": "SPCA",
    "slug": "shirt",
    "sku": "1",
    "manage_stock": false,
    "description": "A shirt",
    "price": [
        {
            "amount": 500,
            "currency": "USD",
            "includes_tax": true
        }
    ],
    "status": "live",
    "commodity_type": "digital",
    "meta": {
        "timestamps": {
            "created_at": "2018-05-03T19:36:31+00:00",
            "updated_at": "2018-08-06T09:40:46+00:00"
        },
        "stock": {
            "level": 0,
            "availability": "out-stock"
        },
        "variations": {
                "id": "ccfb0d2c-8ed5-4dd8-ab41-ba883f4d3fbb",
                "name": "Shirt size",
                "options": [
                    {
                        "id": "581dd431-38f0-415f-98fc-ec64b5aa7f9d",
                        "name": "small",
                        "description": "Size small"
                    },
                    {
                        "id": "f4413e4d-8258-4510-87f9-4af0d75bfcb1",
                        "name": "medium",
                        "description": "Size medium"
                    },
                    {
                        "id": "143814e1-c75f-46d4-8d14-97d15405321f",
                        "name": "large",
                        "description": "Size large"
                    }
                ]
            }
        ]
    },
    "relationships": {
        "variations": {
            "data": [
                {
                    "type": "product-variation",
                    "id": "0c02ca9f-27be-48a8-89d9-cd7c30699343"
                }]
        }
      }
   }
 }

cURL

curl -X POST https://api.moltin.com/v2/products/:id/build/ \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer XXXX"