Go to Dashboard

How can we help?

Popular articles Welcome to Gelato! Getting Started Guide (Manual Orders) Getting Started Guide (Shopify integration) What hangers are a good fit for my poster size? How can I order a framed poster? What print products do you offer? Where can I find product dimensions? How can I check your product pricing? How does the sign-up promotion work? Can I claim back the VAT of my order? Why do I get charged VAT on some orders and not others? VAT on local printing and delivery within EU Where do you print locally? How quickly do you deliver? How do I estimate the pricing 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? Email Notification from Gelato: Order [123] is on hold - Action required Do you offer 24/7 customer support? What is you return policy and quality guarantee? How do I report a problem with my order? 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 shipping method and tracking in the Gelato Dashboard?

Getting Started Guide (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. 

If you want to start using Gelato without doing a full integration with our APIs, please refer to this guide instead.

 

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.

 

API Portal

The API Portal 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.

Read more...

 

Design requirements and product mapping

Please familiarize 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 catalogue available in our API Portal. 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 API Portal. 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: 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?
0 out of 0 found this helpful