> For the complete documentation index, see [llms.txt](https://developers.flipsnack.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.flipsnack.com/products/create.md). # products.create The products.create method allows external systems—such as PIMs, ERPs, or custom integrations—to send product data directly to Flipsnack. Each request must include an apiSecretKey for authentication, a sourceHash to group the products, and a list of product objects. Submitted products become visible in the Automation tab in the Design Studio, replacing the need for manual CSV imports. **Note:** Requests must be made to **** ### Rules & Limitations * Payloads must follow a predefined JSON schema * Up to 500 products per request * Maximum payload size: 200 MB * sourceHash must be generated and persisted by the client and must be a maximum 64-character identifier used to group products under a specific source. Clients are responsible for generating and persisting this value for future updates or deletions * Variants must be nested inside their parent product * Duplicate SKUs within the same request or under the same sourceHash are not allowed ### Feed Organization Clients can submit products under one or multiple sourceHash values, allowing them to manage separate product feeds. **The sourceHash is also required for future updates or deletions.** ## Request parameters | Name | Type | Description | | ----------------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | |

apiKey (required)


| string | The API key provided for your user. If it is not specified, the request will return the error code "30 - Missing mandatory parameter". If the key is incorrect the request returns the error code "41 - Invalid credentials". | | signature (required) | string | The signature must be calculated by you and added to the request. See[ How to sign a request](https://developers.flipsnack.com/how-to-sign-a-request) for more information.If the parameter is missing the request will return the error code "30 - Missing mandatory parameter". If the signature is incorrect the request will return the error code "44 - Invalid signature". | | action (required) | string | The API method that should be called. In this case the value should be products.create. If it is not specified, the request will return the error code "30 - Missing mandatory parameter". | | sourceHash (required) | string | This needs to be a unique identifier within flipsnack to be able to update based on it the products and also to have the possibility to create multiple feeds from the same API | | products (required) | JSON | It’s a JSON containing all the products that are going to pe created | | feedName (required) | string | The name, how the feed will be listed in automation list in app | ### Products example as JSON type Below is an example of the expected JSON structure for products. Notes: * `variants` is optional. If included, it must be an array of objects. * Custom field keys can be any key-value pair, but must not contain dots (`.`) (e.g., use `custom_field` instead of `custom.field`). ```json [ { "type": "string", // required "code": "string", // required "[your_custom_field_1]": "string | number | boolean", "[your_custom_field_2]": "string | number | boolean", "variants": [ // optional { "code": "string", // required "parent_code": "string", // required "[your_custom_field_1]": "string | number | boolean", "[your_custom_field_2]": "string | number | boolean" } ] } ] ``` ## Response parameters | Name | Type | Description | | ---------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | |

code


| string |

Possible values:

| | status | string | Message related to code | | data | JSON | It's a JSON with more details about the response it has a more detailed message about the outcome, errors or data which is an array of exact messages | ## Error codes For complete list of error codes and messages go to [API status codes](/api-status-codes.md) section. ## Examples ### Request {% tabs %} {% tab title="cURL" %} ```bash # GET curl -X POST https://api.flipsnack.com/v1/ \ -F action=products.create \ -F apiKey= \ -F signature= \ -F sourceHash= \ -F products="” ``` {% endtab %} {% tab title="HTML" %} ```html
``` {% endtab %} {% endtabs %} ### Response {% tabs %} {% tab title="Success" %} ``` { "code": 20, "status":"", "data": { "message":"Products created successfully", "errors":[] } } ``` {% endtab %} {% tab title="Error" %} 
{
    "code": 40,
    "status": "",
    "data": {
        "message": "Invalid or incomplete data sent!",
        "errors": [
            "Variable \"$products\" got invalid value \"\" at \"products[0].discount_price\"; Int cannot represent non-integer value: \"\""
        ]
    }
}
{% endtab %} {% endtabs %}