ecommerce/products

Create Products

Changed on

Create Products in any supported Ecommerce software

post/ecommerce/products

Request

  • Base URL
    https://api.panora.dev
  • URL
    https://api.panora.dev/ecommerce/products
  • Auth
    API key in header x-api-key

Query parameters

remote_databoolean

Set to true to include data from the original Accounting software.

Headers

x-connection-tokenstring required

The connection token

Request body

product_urlstring nullable

The URL of the product

product_typestring nullable

The type of the product

product_statusstring nullable

The status of the product. Either ACTIVE, DRAFT OR ARCHIVED.

images_urlsstring[] nullable

The URLs of the product images

descriptionstring nullable

The description of the product

vendorstring nullable

The vendor of the product

variantsVariant[]

The variants of the product

tagsstring[] nullable

The tags associated with the product

field_mappingsobject nullable

The custom field mappings of the object between the remote 3rd party & Panora

Example request

{
  "product_url": "https://product_url/tee",
  "product_type": "teeshirt",
  "product_status": "ACTIVE",
  "images_urls": [
    "https://myproduct/image"
  ],
  "description": "best tee ever",
  "vendor": "vendor_extern",
  "variants": [
    {
      "title": "teeshirt",
      "price": 20,
      "sku": "3",
      "options": null,
      "weight": 10,
      "inventory_quantity": 100
    }
  ],
  "tags": [
    "tag_1"
  ],
  "field_mappings": {
    "fav_dish": "broccoli",
    "fav_color": "red"
  }
}

Response

product_urlstring nullable

The URL of the product

product_typestring nullable

The type of the product

product_statusstring nullable

The status of the product. Either ACTIVE, DRAFT OR ARCHIVED.

images_urlsstring[] nullable

The URLs of the product images

descriptionstring nullable

The description of the product

vendorstring nullable

The vendor of the product

variantsVariant[]

The variants of the product

tagsstring[] nullable

The tags associated with the product

field_mappingsobject nullable

The custom field mappings of the object between the remote 3rd party & Panora

idstring nullable

The UUID of the product

remote_idstring nullable

The remote ID of the product in the context of the 3rd Party

remote_dataobject nullable

The remote data of the customer in the context of the 3rd Party

created_atstring nullable

The created date of the object

modified_atstring nullable

The modified date of the object

Example response

{
  "product_url": "https://product_url/tee",
  "product_type": "teeshirt",
  "product_status": "ACTIVE",
  "images_urls": [
    "https://myproduct/image"
  ],
  "description": "best tee ever",
  "vendor": "vendor_extern",
  "variants": [
    {
      "title": "teeshirt",
      "price": 20,
      "sku": "3",
      "options": null,
      "weight": 10,
      "inventory_quantity": 100
    }
  ],
  "tags": [
    "tag_1"
  ],
  "field_mappings": {
    "fav_dish": "broccoli",
    "fav_color": "red"
  },
  "id": "801f9ede-c698-4e66-a7fc-48d19eebaa4f",
  "remote_id": "id_1",
  "remote_data": {
    "fav_dish": "broccoli",
    "fav_color": "red"
  },
  "created_at": "2024-10-01T12:00:00Z",
  "modified_at": "2024-10-01T12:00:00Z"
}

Changes

  • be3dc330edf3Revision changes
    • breaking

      removed the enum value ACTIVE of the request property

    • breaking

      removed the enum value ARCHIVED of the request property

    • breaking

      removed the enum value DRAFT of the request property

    • info

      removed the ACTIVE enum value from the response property for the response status

    • info

      removed the ARCHIVED enum value from the response property for the response status

    • info

      removed the DRAFT enum value from the response property for the response status

  • 87189baf7791Revision changes
    • breaking

      request property was restricted to a list of enum values

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • warning

      added the new ACTIVE enum value to the response property for the response status

    • warning

      added the new ARCHIVED enum value to the response property for the response status

    • warning

      added the new DRAFT enum value to the response property for the response status

    • info

      the request property became nullable

    • info

      the request property became nullable

    • info

      the request property became nullable

    • info

      the request property became nullable

    • info

      the request property became nullable

    • info

      the request property became nullable

    • info

      the request property became nullable

    • info

      the request property became nullable

    • info

      added the new ACTIVE enum value to the request property

    • info

      added the new ARCHIVED enum value to the request property

    • info

      added the new DRAFT enum value to the request property