Developer Resources > Examples



In this section, we share tips on how to troubleshoot common errors about:

Making Query Connections:

When querying for connection fields, if no first or last parameter is specified, a default of first: 100 is assumed.

Cannot request more than 100 items per connection field.

For example, a query like the following:

query {
  purchase_orders {
    data {
      edges {
        node {
          line_items {
            edges {
              node {

Has a connection for line_items inside purchase_ordes, so this means that if we don’t specify line_items(first:10) and purchase_orders(first:10) the complexity would be of 10001 (100 purchase_orders * 100 line_items each + 1 ), even if the PO does not have 100 line items or 100 purchase orders.

Client IDE not connecting:

A common error you might be having when trying to view de Docs & Schema using any of our recomended Client IDEs is not being able to access the docs.

For this purpose, we have a couple of suggestions:

  1. Using the Desktop Versions or Extensions of this Client IDEs. Usually, Web versions of these clients tend to have this kind of issue.
  2. Disabling cache on the Client IDE*

*you can do this by opening dev tools from inside the Client IDE and selecting Disable cache


All dates are stored as UTC

ISODateTime: A DateTime field type that understand ISO 8601 strings, besides datetime objects. It supports strings with and without times, as well as using T or space as delimiter


  • YYYY-mm-dd
  • YYYY-mm-dd HH:MM:SS
  • YYYY-mm-ddTHH:MM:SS


Input dimensions are considered to be in the account’s settings unit, unless specified by the field name like weight_in_lbs
Output dimensions will always be in the account’s settings unit, unless specified by the field name like weight_in_lbs

Available Inventory:

The available field inside warehouse_products has a default cost of 30.

The reason for this is that it has complex calculations to figure out the available quantities (For example, it checks if the product is virtual, if it’s a Kit or inside a Kit and figuring out the component with lower inventory, the sell ahead quantity of that product on Purchase Orders amongst other variables)

Custom options:

The available field inside line_items, called custom_options should have the following format:

custom_options: "[{'label':'Size','value':'10'}]"

So for example if you are trying to create an order using this field, the line items section should look something like this:

line_items: [
          custom_options: "[{'label':'Size','value':'10'}]"
          eligible_for_return: false
          partner_line_item_id: "113355-Jean-11234"
          price: "8.00"
          product_name: "Jeans"
          quantity: 1
          quantity_pending_fulfillment: 1
          sku: "1011223344"

Country/State codes:

On the order_create mutation, for the shipping address you will see the following fields:

shipping_address: {
        address1: "2326 Street Dr"
        address2: ""
        city: "Fort Collins"
        company: ""
        country: "US"
        country_code: "US"
        email: "EXAMPLE@GMAIL.COM"
        first_name: "John"
        last_name: "Johnson"
        phone: "(970) 111-111"
        state: "CO"
        state_code: "CO"
        zip: "80528"

Both country_code and state_code have been deprecated.
In order to create successfully the order, country has to be the valid country code, for example, “US”, and similar, the state has to be a valid state code such as “CO”