> ## Documentation Index
> Fetch the complete documentation index at: https://docs.platinur.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Shopify

> Sync Shopify orders, products, and customers through the Admin GraphQL API.

## Create the credential

In Shopify Admin, open **Settings → Apps and sales channels → Develop apps**, create a custom app
for Platinur, and configure its Admin API scopes. Grant only `read_orders`, `read_products`,
and/or `read_customers` for the objects you will select. Install the app, then copy the Admin API
access token. Copy the shop name from the permanent `your-store.myshopify.com` address; do not use
a custom storefront domain and do not include `https://` or `/admin`.

## Connect

1. Open **Integrations → New Source → Shopify**.
2. Enter the store name and Admin API access token.
3. Choose Orders, Products, and/or Customers.
4. Test the connection, create the source, and discover the selected objects in **Schema**.
5. Run the first sync and optionally add a schedule.

Paste the shop-name portion into **Store name** and the copied token into **Admin API access
token**. **Test endpoint** verifies the installed app's token. After creation, confirm the selected
objects in **Schema** and run the first **Sync**.

Platinur uses the versioned, read-only Admin GraphQL API—not the legacy REST Admin API. It follows
GraphQL cursors, respects throttling with bounded retries, and enforces Shopify's 25,000-object
pagination boundary. Larger histories must be narrowed before they can be certified as complete.

## Common failures

* **401 unauthorized:** reinstall the app or replace the Admin API access token, then test again.
* **Access denied:** add the matching read scope to the custom app, reinstall it, and select only
  the authorized objects.
* **Shop not found:** enter only `your-store` or the `your-store.myshopify.com` shop identifier,
  not a custom domain or a full URL.
* **Large history limit:** narrow the source history or work with support before treating a
  25,000-object result as complete.

## Rotate or revoke access

Rotate or recreate the custom-app token in Shopify, paste the new token in the source **Config**
tab, and **Test endpoint** before revoking the old token. To revoke immediately, disable or delete
the source and uninstall the custom app or revoke its token in Shopify.

See Shopify's [Admin GraphQL API](https://shopify.dev/docs/api/admin-graphql/latest),
[authentication guide](https://shopify.dev/docs/api/usage/authentication), and
[API limits](https://shopify.dev/docs/api/usage/limits).