Getting started

Build a custom app

Custom apps are built for a single store — by the merchant or a developer they trust. There is no OAuth: the merchant installs the app and hands you its token.

1. In the Sellify admin go to Apps → Develop apps and click Create app.
2. Select the access scopes the app needs (as few as possible) and Save scopes.
3. Click Install app. Copy the Admin API access token (sfat_…) — it is shown once.
4. Optionally add webhooks and copy the signing secret.

Your first request

curl -X POST https://admin-sellifyhq.vercel.app/api/admin/2026-10/graphql \
  -H "Content-Type: application/json" \
  -H "X-Sellify-Access-Token: sfat_..." \
  -d '{"query":"{ shop { name currencyCode } products(first: 3) { nodes { id title totalInventory } } }"}'

Node.js

const res = await fetch("https://admin-sellifyhq.vercel.app/api/admin/2026-10/graphql", {
  method: "POST",
  headers: { "Content-Type": "application/json", "X-Sellify-Access-Token": process.env.SELLIFY_TOKEN },
  body: JSON.stringify({
    query: `mutation ($id: ID!, $qty: Int!) {
      inventorySetOnHand(variantId: $id, quantity: $qty) { available userErrors { field message } }
    }`,
    variables: { id: "gid://sellify/ProductVariant/<uuid>", qty: 25 },
  }),
});
const { data, errors, extensions } = await res.json();

Example integrations

• ERP / inventory sync — write_inventory: call inventorySetOnHand from your warehouse system.
• Shipping aggregator — write_orders: subscribe to orders/paid, book the shipment, then call fulfillmentCreate with tracking.
• WhatsApp/SMS notifications — read_orders: subscribe to orders/create and orders/fulfilled.
• COD reconciliation — write_orders: call orderMarkAsPaid when the courier remits.