Assign Related Product In Magento 2 API

Assign Related Product In Magento 2 API

September 16, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Assign Related Product In Magento 2 API

Hello developers! Today, we’re going to tackle a common issue faced by many while working with the Magento 2 API for assigning related products.

Understanding the Problem

Let’s break down the problem as described:

  1. The developer is using the Magento 2 API to assign links like ‘related’ or ‘crosssell’.
  2. They are using the correct API endpoint /V1/products/{sku}/links.
  3. However, they keep receiving the error message: {"message":"%fieldName is required filed.","parameters":{"fieldName":"linkType"}}.

The issue here lies in how Magento expects the data structure for this specific API call.

The Correct Approach

Step 1: Check your API Key and Endpoint

First, ensure you have the correct API key (tn_webshopKey) and that your endpoint is properly formatted. The base URL should be http://www.mywebsite.com/rest/V1/. Double-check these details to rule out any basic configuration errors.

Step 2: Review the API Documentation

The official Magento 2 API documentation provides detailed information about each endpoint, including required fields and data structures. For the /V1/products/{sku}/links endpoint, you can find it here.

Step 3: Correct Your API Data Structure

The error suggests that the linkType is a required field and must be specified in your request data. However, the provided code does include this field:

$productData = array(
    "items" =>  array(
        ...
        "linkType" => 'related',
        ...
    )
);

So, why are you still getting the error? The issue might lie in how Magento interprets your data structure when it is sent as JSON.

The Solution

Correcting Your PHP Code

To ensure proper serialization of your array into a JSON string that matches the API’s expectation, adjust your PHP code like this:

$productData = [
    "items" =>  [
        "sku" => $sku1,
        "linkType" => 'related',
        "linkedProductSku" => $sku2,
        "linkedProductType" => "simple",
        "position" => 0
    ]
];

// Rest of the code...

Using JSON Format Properly

In your $productData array, you are mixing single and double quotes which can cause issues when converted to a JSON string. Stick to using double quotes consistently for all strings in this context.

Testing Your Solution

After making these changes:

  1. Save your script.
  2. Run it again on your local environment or server.
  3. Monitor the API response closely.

If you have configured everything correctly, Magento should now accept your request and assign the linked product as expected.

Conclusion

Solving this issue requires a deep understanding of how Magento 2 handles JSON data structures in its APIs. Always refer to the official documentation for accurate information about required fields and their formats.

Remember that even small syntax errors can lead to significant issues when working with RESTful APIs. Pay close attention to your JSON serialization process, especially when dealing with nested arrays in PHP.

If you’re looking for more advanced guides on Magento 2 development, consider exploring our Magento 2 tutorials at LaravelCompany. We provide comprehensive resources to help developers like you master the platform effectively.

Magento 2 Catalog API Admin

Our network