arrow_back Back to all endpoints
POST https://v2.api.finerworks.com/v3/create_template

Create Template

Creates a template object from a product.

Body

Name Description Type Additional information
product product None.
product_code Product code associated with the product. This is required to calculate a price for the product and to know how to frame or mat the product if needed. text None.
product_qty Optional - can affect the price if the product code used has a quantity break. Default is 1. number None.
account_key Optional - User account associated with the request. Note, this will only be accepted for accounts with permission to utilize this parameter, otherwise it will be ignored and the request will based upon the user's api credentials. Leave as null if not authorized to use this parameter. text None.

Example JSON Body

application/json, text/json

{
  "product": {
    "product_order_po": "sample string 1",
    "product_qty": 2,
    "product_sku": "sample string 3",
    "product_image": {
      "pixel_width": 1,
      "pixel_height": 2,
      "product_url_file": "sample string 3",
      "product_url_thumbnail": "sample string 4",
      "library_file": {
        "id": 1,
        "guid": "52f3da45-79de-4761-ab4d-bb20d1bad856",
        "title": "sample string 3",
        "description": "sample string 4",
        "file_name": "sample string 5",
        "file_size": 6,
        "thumbnail_file_name": "sample string 7",
        "preview_file_name": "sample string 8",
        "hires_file_name": "sample string 9",
        "public_thumbnail_uri": "sample string 10",
        "public_preview_uri": "sample string 11",
        "personal_gallery_title": "sample string 12",
        "members_gallery_category": "sample string 13",
        "private_hires_uri": "sample string 14",
        "pix_w": 15,
        "pix_h": 16,
        "date_added": "2026-09-15T02:37:25.5231685-05:00",
        "date_updated": "2026-09-15T02:37:25.5231685-05:00",
        "date_expires": "2026-09-15T02:37:25.5231685-05:00",
        "active": true,
        "products": [
          {
            "id": 1,
            "monetary_format": "sample string 2",
            "quantity": 3,
            "quantity_in_stock": 4,
            "track_inventory": true,
            "sku": "sample string 6",
            "product_code": "sample string 7",
            "price_details": {
              "product_qty": 1,
              "product_sku": "sample string 2",
              "product_code": "sample string 3",
              "product_price": 4.1,
              "add_frame_price": 5.1,
              "add_mat_1_price": 6.1,
              "add_mat_2_price": 7.1,
              "add_glazing_price": 8.1,
              "add_color_correct_price": 9.1,
              "total_price": 10.1,
              "geo_price": 11.1,
              "info": "sample string 12",
              "debug": {}
            },
            "per_item_price": 8.0,
            "total_price": 9.0,
            "asking_price": 10.0,
            "geo_price": 11.0,
            "artist": "sample string 12",
            "name": "sample string 13",
            "description_short": "sample string 14",
            "description_long": "sample string 15",
            "labels": [
              {
                "key": "sample string 1",
                "value": "sample string 2",
                "priority": 3
              },
              {
                "key": "sample string 1",
                "value": "sample string 2",
                "priority": 3
              }
            ],
            "image_url_1": "sample string 16",
            "image_url_2": "sample string 17",
            "image_url_3": "sample string 18",
            "image_url_4": "sample string 19",
            "image_url_5": "sample string 20",
            "image_guid": "2339dcf8-403c-49de-92cc-a920362aae2c",
            "product_size": {
              "width": 1.0,
              "height": 2.0,
              "depth": 3.0,
              "ounces": 4.0,
              "cubic_volume": 5.0,
              "is_rigid": true
            },
            "third_party_integrations": {
              "etsy_product_id": 1,
              "shopify_product_id": 2,
              "shopify_variant_id": 3,
              "shopify_graphql_product_id": "sample string 4",
              "shopify_graphql_variant_id": "sample string 5",
              "squarespace_product_id": "sample string 6",
              "squarespace_variant_id": "sample string 7",
              "square_product_id": "sample string 8",
              "square_variant_id": "sample string 9",
              "bigcommerce_id": "sample string 10",
              "bigcommerce_variant_id": "sample string 11",
              "wix_inventory_id": "sample string 12",
              "wix_product_id": "sample string 13",
              "wix_variant_id": "sample string 14",
              "woocommerce_product_id": 15,
              "woocommerce_variant_id": 16
            },
            "framing_options": {
              "collection_ids": [
                1,
                2
              ],
              "allow_frames": true,
              "allow_matting": true,
              "allow_glazing": true,
              "frame_required": true,
              "allow_float_matting": true,
              "require_float_matting": true
            },
            "product_guid": "eb898cd9-823f-4e85-8390-e6e025f62da3",
            "updated": "2026-09-15T02:37:25.5231685-05:00",
            "valid": true,
            "debug": {}
          },
          {
            "id": 1,
            "monetary_format": "sample string 2",
            "quantity": 3,
            "quantity_in_stock": 4,
            "track_inventory": true,
            "sku": "sample string 6",
            "product_code": "sample string 7",
            "price_details": {
              "product_qty": 1,
              "product_sku": "sample string 2",
              "product_code": "sample string 3",
              "product_price": 4.1,
              "add_frame_price": 5.1,
              "add_mat_1_price": 6.1,
              "add_mat_2_price": 7.1,
              "add_glazing_price": 8.1,
              "add_color_correct_price": 9.1,
              "total_price": 10.1,
              "geo_price": 11.1,
              "info": "sample string 12",
              "debug": {}
            },
            "per_item_price": 8.0,
            "total_price": 9.0,
            "asking_price": 10.0,
            "geo_price": 11.0,
            "artist": "sample string 12",
            "name": "sample string 13",
            "description_short": "sample string 14",
            "description_long": "sample string 15",
            "labels": [
              {
                "key": "sample string 1",
                "value": "sample string 2",
                "priority": 3
              },
              {
                "key": "sample string 1",
                "value": "sample string 2",
                "priority": 3
              }
            ],
            "image_url_1": "sample string 16",
            "image_url_2": "sample string 17",
            "image_url_3": "sample string 18",
            "image_url_4": "sample string 19",
            "image_url_5": "sample string 20",
            "image_guid": "2339dcf8-403c-49de-92cc-a920362aae2c",
            "product_size": {
              "width": 1.0,
              "height": 2.0,
              "depth": 3.0,
              "ounces": 4.0,
              "cubic_volume": 5.0,
              "is_rigid": true
            },
            "third_party_integrations": {
              "etsy_product_id": 1,
              "shopify_product_id": 2,
              "shopify_variant_id": 3,
              "shopify_graphql_product_id": "sample string 4",
              "shopify_graphql_variant_id": "sample string 5",
              "squarespace_product_id": "sample string 6",
              "squarespace_variant_id": "sample string 7",
              "square_product_id": "sample string 8",
              "square_variant_id": "sample string 9",
              "bigcommerce_id": "sample string 10",
              "bigcommerce_variant_id": "sample string 11",
              "wix_inventory_id": "sample string 12",
              "wix_product_id": "sample string 13",
              "wix_variant_id": "sample string 14",
              "woocommerce_product_id": 15,
              "woocommerce_variant_id": 16
            },
            "framing_options": {
              "collection_ids": [
                1,
                2
              ],
              "allow_frames": true,
              "allow_matting": true,
              "allow_glazing": true,
              "frame_required": true,
              "allow_float_matting": true,
              "require_float_matting": true
            },
            "product_guid": "eb898cd9-823f-4e85-8390-e6e025f62da3",
            "updated": "2026-09-15T02:37:25.5231685-05:00",
            "valid": true,
            "debug": {}
          }
        ],
        "assigned_gallery_subcategory_ids": [
          1,
          2
        ],
        "assigned_personal_gallery_ids": [
          1,
          2
        ],
        "username": "sample string 20",
        "account_key": "sample string 21",
        "artistname": "sample string 22",
        "rank": 23
      }
    },
    "product_title": "sample string 5",
    "template": {
      "id": "38f0ce57-6898-4d82-aba0-40b8107bc2f2",
      "thumbnail_url": "sample string 2",
      "product_code": "sample string 3"
    },
    "product_guid": "2e9fd6ad-6dc2-49f8-a741-70755ca6da66",
    "custom_data_1": "sample string 7",
    "custom_data_2": "sample string 8",
    "custom_data_3": "sample string 9",
    "coa": {
      "artist": "sample string 1",
      "image_guid": "289a1354-6735-44c5-8b02-9da665910561",
      "product_id": 3,
      "description": "sample string 4",
      "edition_number": 5,
      "edition_count": 6,
      "type": 7,
      "color_scheme": 8
    }
  },
  "product_code": "sample string 1",
  "product_qty": 2,
  "account_key": "sample string 3"
}

Sample Code Library

curl --location --request POST 'https://v2.api.finerworks.com/v3/create_template' \
--header 'Content-Type: application/json' \
--header 'web_api_key: my-web-api-key-goes-here' \
--header 'app_key: my-app-key-goes-here' \
--data-raw '{
  "product": {
    "product_order_po": "sample string 1",
    "product_qty": 2,
    "product_sku": "sample string 3",
    "product_image": {
      "pixel_width": 1,
      "pixel_height": 2,
      "product_url_file": "sample string 3",
      "product_url_thumbnail": "sample string 4",
      "library_file": {
        "id": 1,
        "guid": "52f3da45-79de-4761-ab4d-bb20d1bad856",
        "title": "sample string 3",
        "description": "sample string 4",
        "file_name": "sample string 5",
        "file_size": 6,
        "thumbnail_file_name": "sample string 7",
        "preview_file_name": "sample string 8",
        "hires_file_name": "sample string 9",
        "public_thumbnail_uri": "sample string 10",
        "public_preview_uri": "sample string 11",
        "personal_gallery_title": "sample string 12",
        "members_gallery_category": "sample string 13",
        "private_hires_uri": "sample string 14",
        "pix_w": 15,
        "pix_h": 16,
        "date_added": "2026-09-15T02:37:25.5231685-05:00",
        "date_updated": "2026-09-15T02:37:25.5231685-05:00",
        "date_expires": "2026-09-15T02:37:25.5231685-05:00",
        "active": true,
        "products": [
          {
            "id": 1,
            "monetary_format": "sample string 2",
            "quantity": 3,
            "quantity_in_stock": 4,
            "track_inventory": true,
            "sku": "sample string 6",
            "product_code": "sample string 7",
            "price_details": {
              "product_qty": 1,
              "product_sku": "sample string 2",
              "product_code": "sample string 3",
              "product_price": 4.1,
              "add_frame_price": 5.1,
              "add_mat_1_price": 6.1,
              "add_mat_2_price": 7.1,
              "add_glazing_price": 8.1,
              "add_color_correct_price": 9.1,
              "total_price": 10.1,
              "geo_price": 11.1,
              "info": "sample string 12",
              "debug": {}
            },
            "per_item_price": 8.0,
            "total_price": 9.0,
            "asking_price": 10.0,
            "geo_price": 11.0,
            "artist": "sample string 12",
            "name": "sample string 13",
            "description_short": "sample string 14",
            "description_long": "sample string 15",
            "labels": [
              {
                "key": "sample string 1",
                "value": "sample string 2",
                "priority": 3
              },
              {
                "key": "sample string 1",
                "value": "sample string 2",
                "priority": 3
              }
            ],
            "image_url_1": "sample string 16",
            "image_url_2": "sample string 17",
            "image_url_3": "sample string 18",
            "image_url_4": "sample string 19",
            "image_url_5": "sample string 20",
            "image_guid": "2339dcf8-403c-49de-92cc-a920362aae2c",
            "product_size": {
              "width": 1.0,
              "height": 2.0,
              "depth": 3.0,
              "ounces": 4.0,
              "cubic_volume": 5.0,
              "is_rigid": true
            },
            "third_party_integrations": {
              "etsy_product_id": 1,
              "shopify_product_id": 2,
              "shopify_variant_id": 3,
              "shopify_graphql_product_id": "sample string 4",
              "shopify_graphql_variant_id": "sample string 5",
              "squarespace_product_id": "sample string 6",
              "squarespace_variant_id": "sample string 7",
              "square_product_id": "sample string 8",
              "square_variant_id": "sample string 9",
              "bigcommerce_id": "sample string 10",
              "bigcommerce_variant_id": "sample string 11",
              "wix_inventory_id": "sample string 12",
              "wix_product_id": "sample string 13",
              "wix_variant_id": "sample string 14",
              "woocommerce_product_id": 15,
              "woocommerce_variant_id": 16
            },
            "framing_options": {
              "collection_ids": [
                1,
                2
              ],
              "allow_frames": true,
              "allow_matting": true,
              "allow_glazing": true,
              "frame_required": true,
              "allow_float_matting": true,
              "require_float_matting": true
            },
            "product_guid": "eb898cd9-823f-4e85-8390-e6e025f62da3",
            "updated": "2026-09-15T02:37:25.5231685-05:00",
            "valid": true,
            "debug": {}
          },
          {
            "id": 1,
            "monetary_format": "sample string 2",
            "quantity": 3,
            "quantity_in_stock": 4,
            "track_inventory": true,
            "sku": "sample string 6",
            "product_code": "sample string 7",
            "price_details": {
              "product_qty": 1,
              "product_sku": "sample string 2",
              "product_code": "sample string 3",
              "product_price": 4.1,
              "add_frame_price": 5.1,
              "add_mat_1_price": 6.1,
              "add_mat_2_price": 7.1,
              "add_glazing_price": 8.1,
              "add_color_correct_price": 9.1,
              "total_price": 10.1,
              "geo_price": 11.1,
              "info": "sample string 12",
              "debug": {}
            },
            "per_item_price": 8.0,
            "total_price": 9.0,
            "asking_price": 10.0,
            "geo_price": 11.0,
            "artist": "sample string 12",
            "name": "sample string 13",
            "description_short": "sample string 14",
            "description_long": "sample string 15",
            "labels": [
              {
                "key": "sample string 1",
                "value": "sample string 2",
                "priority": 3
              },
              {
                "key": "sample string 1",
                "value": "sample string 2",
                "priority": 3
              }
            ],
            "image_url_1": "sample string 16",
            "image_url_2": "sample string 17",
            "image_url_3": "sample string 18",
            "image_url_4": "sample string 19",
            "image_url_5": "sample string 20",
            "image_guid": "2339dcf8-403c-49de-92cc-a920362aae2c",
            "product_size": {
              "width": 1.0,
              "height": 2.0,
              "depth": 3.0,
              "ounces": 4.0,
              "cubic_volume": 5.0,
              "is_rigid": true
            },
            "third_party_integrations": {
              "etsy_product_id": 1,
              "shopify_product_id": 2,
              "shopify_variant_id": 3,
              "shopify_graphql_product_id": "sample string 4",
              "shopify_graphql_variant_id": "sample string 5",
              "squarespace_product_id": "sample string 6",
              "squarespace_variant_id": "sample string 7",
              "square_product_id": "sample string 8",
              "square_variant_id": "sample string 9",
              "bigcommerce_id": "sample string 10",
              "bigcommerce_variant_id": "sample string 11",
              "wix_inventory_id": "sample string 12",
              "wix_product_id": "sample string 13",
              "wix_variant_id": "sample string 14",
              "woocommerce_product_id": 15,
              "woocommerce_variant_id": 16
            },
            "framing_options": {
              "collection_ids": [
                1,
                2
              ],
              "allow_frames": true,
              "allow_matting": true,
              "allow_glazing": true,
              "frame_required": true,
              "allow_float_matting": true,
              "require_float_matting": true
            },
            "product_guid": "eb898cd9-823f-4e85-8390-e6e025f62da3",
            "updated": "2026-09-15T02:37:25.5231685-05:00",
            "valid": true,
            "debug": {}
          }
        ],
        "assigned_gallery_subcategory_ids": [
          1,
          2
        ],
        "assigned_personal_gallery_ids": [
          1,
          2
        ],
        "username": "sample string 20",
        "account_key": "sample string 21",
        "artistname": "sample string 22",
        "rank": 23
      }
    },
    "product_title": "sample string 5",
    "template": {
      "id": "38f0ce57-6898-4d82-aba0-40b8107bc2f2",
      "thumbnail_url": "sample string 2",
      "product_code": "sample string 3"
    },
    "product_guid": "2e9fd6ad-6dc2-49f8-a741-70755ca6da66",
    "custom_data_1": "sample string 7",
    "custom_data_2": "sample string 8",
    "custom_data_3": "sample string 9",
    "coa": {
      "artist": "sample string 1",
      "image_guid": "289a1354-6735-44c5-8b02-9da665910561",
      "product_id": 3,
      "description": "sample string 4",
      "edition_number": 5,
      "edition_count": 6,
      "type": 7,
      "color_scheme": 8
    }
  },
  "product_code": "sample string 1",
  "product_qty": 2,
  "account_key": "sample string 3"
}'