Creating Custom Options on a Product using the Magento API

Creating Custom Options on a Product using the Magento API

July 29, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Creating Custom Options on a Product using the Magento API

Creating Custom Options on Magento Products via API

Introduction

In this post, we’ll guide you through the process of adding custom options to Magento products using the SOAP API. We’ll be focusing on C#, but providing PHP examples as well for a broader audience.

Understanding the Magento Product Object Structure

The catalogProductCreateEntity object in Magento’s API contains many properties to define a product, including the options_container field which represents the container holding all custom options associated with the product.

var product = new catalogProductCreateEntity();
product.options_container = "blah";

Similarly, the catalogAttributeOptionEntity class represents an individual option within this container. It has fields for the option’s label and value:

$optionEntity = new catalogAttributeOptionEntity();
$optionEntity->value = "sds";
$optionEntity->label = "ere";

The Challenge: Missing API Properties

While these classes exist, the catalogAttributeOptionEntity doesn’t contain all properties needed to create a custom option—it lacks fields for price, default value, and other settings available in the Magento backend.

Our Approach

Step 1: Create Custom Option Objects Manually

Since the API doesn’t provide a pre-built object for creating options, we’ll need to construct them manually using the catalogProductOptionEntity class.

Here’s an example in C#:

var option = new catalogProductOptionEntity();
option.option_id = 0;
option.title = "Custom Option Title";
option.type = "drop_down";
option.is_require = 1; // 1 means required, 0 means optional

Step 2: Populate Options and Values

Next, we need to populate the catalogProductOptionValueEntity objects for each option’s available values:

var value = new catalogProductOptionValueEntity();
value.option_value_id = 0;
value.value = "Value A";
value.title = "Option Value Label";
value.sort_order = 1; // The order in which the options will be displayed

option.values.Add(value);

Step 3: Add Options to the Product Container

Finally, we add our custom option objects to the product.options_container array:

product.options_container.Add(option);

Putting It All Together

Here’s a complete example of creating a product with a custom option using the Magento API in C#:

var client = new SoapClient("MagentoService.asmx?wsdl", new SoapClientCredentials());

// Prepare the base product data
var product = new catalogProductCreateEntity();

// Add properties like name, price, etc. (not shown)

// Create custom options
var option = new catalogProductOptionEntity();
option.option_id = 0;
option.title = "Custom Option Title";
option.type = "drop_down";

// Create option values
for (int i = 1; i <= 5; i++)
{
    var value = new catalogProductOptionValueEntity();
    value.option_value_id = 0;
    value.value = $"Option Value {i}";
    value.title = $"Option Value {i} Label";
    value.sort_order = i;

    option.values.Add(value);
}

// Add the custom option to the product
product.options_container.Add(option);

// Call the API service to create the product
client.CreateProduct("admin_username", "admin_password", new[] { product });

Conclusion

While Magento’s SOAP API doesn’t provide a direct way to create custom options, we can manually construct the necessary objects and add them to the product. This allows us to programmatically manage product attributes just like we would in the backend.

Remember that you’ll need to handle API authentication (“admin_username” and “admin_password”) according to your site’s configuration.

For more detailed information on Magento API usage, feel free to explore our comprehensive guide at Laravel Company.

Catalog API Admin Configuration

Our network