> 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 Create new products within flipsnack 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 %}