Use the Marketsy API

Read products and orders, create carts and manage discount codes from your own code. Comes with the Premium plan.

Updated 12 Oct 20262 min read

On this page

The API lets your own code read your products and orders, create carts and manage discount codes. It comes with the Premium plan.

Get your key

In your admin, go to Integrations → API access. Your API key is made the first time you open the page. Click it to copy it.

Send requests to your store's address, then /api/ and the endpoint name. For example: https://yourstore.marketsy.ai/api/GetProducts.
Put the key in the Authorization header, on its own, with nothing in front of it (no "Bearer").
A missing or wrong key gets a 403 error. So does a request from a store whose plan no longer includes the API.

Endpoint	What it does
`GetProducts`	Your published products, up to 100. File links aren't included.
`GetOrders`	Your orders and unpaid carts, up to 100. Filter with `status`, `orderNumber` or `updatedAfter`.
`CreateCart`	Makes a cart from your products, with the prices and quantities you send, and returns a `checkoutUrl` to send a buyer to.
`GetPromoCodes`	Lists your discount codes.
`AddPromoCode`	Adds a discount code. Leave out the code and one is made for you.
`UpdatePromoCodeById`	Changes a discount code.
`DeletePromoCodeById`	Deletes a discount code.

Orders come in the same format as webhooks send them.

For each endpoint's fields and examples, click Read the API docs on the API access page, or open the Marketsy API docs.

On other plans the API access page is greyed out with See plans. See Plans and what they include.

Was this article helpful?

Still stuck?

Write to us in the chat. A real person on the Marketsy team answers, and you'll get the reply here and by email.