Go to Dashboard

How can we help?

Popular articles Welcome To Gelato! Getting Started with Manual Orders Getting Started with Shopify Getting Started with Etsy Getting Started with WooCommerce Getting Started with Wix Getting Started with Squarespace Getting Started with BigCommerce Why do Packaging Insert and Branded Label matter? Don’t they just increase costs? Are Packaging Insert and Branded Label available with all subscription plans? Are Packaging Insert and Branded Label available for all products and regions? Can I select to deliver Packaging Insert and Branded Label only to a specific country? Can I activate a Packaging Insert and/or Branded Label at a product type level (e.g. Poster) or at a variant level (e.g. Museum-Quality Matte Paper Poster)? How can I check your product price? What is the design editor? What are the design requirements for PDF uploads? How can I save my design in Gelato? How does the integration with Getty Images work? How does the integration with Shutterstock work? What print products do you offer? What's the difference between Ready-to-Hang Framed Posters and Framed Posters? Frames & Hangers - Stock Status Why do I get charged VAT/tax on some orders and not others? How do I add Gelato products to my Shopify store? How do I move my existing Shopify products to Gelato? How can I import orders from Shopify? How can I order customized designs through Shopify? Can I add a new variant to an existing product in Shopify? How can I delete a product or variant from my Shopify store? How do I set up shipping in Shopify? Why aren't my customers charged an extra shipping fee for additional items (Shopify)? How do I automatically apply Gelato live shipping prices to my Shopify store? How can I disable the vendor name under the product title in Shopify? How do I add Gelato products to my Etsy store? How do I move my existing Etsy listings to Gelato? How can I order customized designs through Etsy? How can I delete a product or variant from my Etsy store? How do I set up shipping for Etsy? What should I set the shipping origin to in the shipping profiles for Etsy? Do I have to list Gelato as a production partner on Etsy? How Can I Import Orders From WooCommerce? How do I add Gelato products to my WooCommerce store? How do I move my existing WooCommerce products to Gelato? How can I order customized designs through WooCommerce? Can I add a new variation to an existing product in WooCommerce? How can I delete Gelato products from my Woocommerce store? How do I set up shipping for WooCommerce? How do I automatically apply Gelato live shipping prices to my WooCommerce store? How can I import orders from Wix? How can I import orders from Squarespace? How can I import orders from BigCommerce? Where do you print locally? How quickly do you deliver? How do I estimate the price for shipping? Where can I find the flat rates for shipping? How do I see where a specific product is being printed? I receive an error message when I try to place an order. What should I do? How do I place a manual order via the Gelato Dashboard? How do I check the order status in the Gelato Dashboard? How do I check estimated delivery date and tracking in the Gelato Dashboard? What is the manual order approval workflow? What is our default order approval workflow? Email Notification from Gelato: Order [123] is on hold - Action required How do I contact Gelato? Do you offer 24/7 customer support? What is your return policy and quality guarantee? How do I report a problem with my order? What is Gelato+? Gelato+ Subscription FAQs

Getting Started with API Integration

Welcome to Gelato API!

In this guide, you will find the most important information to get started if you want to integrate with our APIs. 

Technical documentation

Start by reviewing our technical documentation available here. 

Important: It is essential that your technical team responsible for the integration is fully aware of this and all the different requirements. Also, review this periodically as we might update it and/or add more functionalities.

Gelato Dashboard

The Gelato Dashboard is the "control panel" for your Gelato API experience. It contains detailed information about the products that our global network supports (including pricing) and gives you full control over the orders placed through Gelato API.

Design requirements and product mapping

Please familiarize yourself with our design requirements and make sure that the files you submit are following our guidelines as this will ensure optimal print results.

Also, please ensure that you understand the concept of product UID and how to map your products to Gelato standards.

Exploring products and prices

If you want to know what products we support, their specifications, the geographical limitations and the prices per country and quantity, please refer to the product catalog available from our dashboard. Additional information on products and design can be found here.

Note: Shipping prices are live as they depend on the shipping methods available in each country at the moment you place the order, hence you will not find them in the dashboard. For more information on how to determine shipping prices, please read here.

Testing

Once you are ready to start testing, please generate a key and put this key to X-API-KEY header of your HTTP requests. You will be able to test the following:

Note: Orders will be automatically canceled and not shipped.

Note: This call will always return Cancelled status in Sandbox.

Tip: You can also start requesting quotes and placing test orders before the integration on your side is completed using the API Portal. This will allow you to get an initial understanding of the information required, how to correctly match files with the right product UID and the responses you might get.

If you use a key in your Live environment, you will be able to get the orders shipped and delivered to the address provided and test the end-to-end flow.

Additional information

  • Shipping: The most important information around shipping  
  • Customer service: A detailed description of our customer service process and the kind of information we need from you
  • Terms of use: Our general terms of use of the service

 

Was this article helpful?
23 out of 32 found this helpful