Skip to main content
Every page in this section has a Try it panel. Paste your API key, fill in the fields, and press Send. The response shows right under the request.
Send makes real changes. A POST, PATCH or DELETE creates, edits or deletes real data in your store. Use a test store, or a key with read-only scopes, while you explore.

​
Before you start

1

Create an API key

Open Dashboard → Developers → API keys and create a key. Pick the store and the scopes you need. See API keys.
2

Find your store ID

Call Get the store, or copy the ID from the dashboard URL. Put it in the storeId field of every request.
3

Paste the key

In the Authorization field, paste the key that starts with mk_live_. The docs send it as Authorization: Bearer mk_live_….

​
Limits

  • 120 requests per minute per key. Over the limit returns 429.
  • A missing or wrong key returns 401. A key without the scope returns 403.
  • Every response is JSON.
The written reference for each area is in Merchant API. The machine-readable spec is merchant-v1.json.