Things Shopify doesn't tell you when building an app

I recently shipped MetaBulkify , a Shopify app for bulk editing metaobjects via CSV. ( Part 1 covers the metaobject-specific challenges.) The metaobject stuff was hard, but the Shopify platform stuff was harder. Here are three traps that aren't obvious from the docs. 1. OAuth scopes are two things that look like one thing Week 1 of development. Nothing works. metaobjectDefinitions query returns an empty array. No error message. Just... nothing. The problem? read_metaobjects and read_metaobject_d