Setting up Stockpost — from install to first ingest

Ten minutes end to end. Assumes you have one supplier who already emails you stock reports.

1. Install from the Shopify App Store. Search "Stockpost" on apps.shopify.com and click Install on your store. Approve the requested scopes — just read_products and write_products, nothing about orders or customer data.
2. Start the 14-day trial. On first launch the app asks you to pick a plan. Pick Starter, approve the $39/month charge inside Shopify admin. You won't be billed until day 15; uninstalling before then costs zero.
3. Copy your inbound address. On the home screen you'll see an address like shop-q7k2p9x4n1@inbound.stockpost.app. That's unique to your store. Suppliers will send stock reports here.
4. Add a supplier. In the Suppliers tab, click "Add supplier." Name them whatever you call them internally ("Acme Dropship", "Nordic Wholesale"). This is just a label.
5. Add the sender allowlist. On the supplier detail page, add the email addresses the supplier sends from. Usually one (stock@acmedropship.com); sometimes two or three for different regional teams. Any email arriving from an address not on the list will be rejected.
6. Map the columns. Upload a sample of the supplier's CSV or XLSX — the most recent one they sent you works. The app previews the file and asks you to pick the SKU column, the on-hand column, and (optionally) the with-supplier column. This mapping sticks; you don't do it again per email.
7. Ask the supplier to use the new address. One email, "please send stock reports to shop-q7k2p9x4n1@inbound.stockpost.app going forward" — forward the one they sent you last week to the address yourself, as a test.
8. Watch Ingests. Within a minute or two the test email will appear under Ingests with a status. If it's green, you're done — metafields are now being written on matched products. If it's red, the reject reason will tell you what to fix (usually an unexpected column header or a sender not on the allowlist).

What you've got now

Every email from that supplier is now:

• Authenticated via SPF / DKIM / DMARC on SES.
• Authorised against your allowlist.
• Parsed into stock rows.
• Matched against your Shopify products by SKU.
• Written to stock.on_hand and stock.with_supplier metafields on the matching product.
• Recorded in the ingest audit log with the raw email retained for 60 days.

You can surface those metafields on your admin product pages by adding metafield definitions in Shopify (Settings → Custom data → Products), and in your Online Store or Shopify Flow rules.

If something didn't work

• Email rejected: sender not allowlisted. Add the exact sending address to the supplier's allowlist.
• Email rejected: verdict failed. SPF or DKIM didn't pass. Check whether the supplier forwards through a third-party service that breaks signing.
• Zero rows parsed. Your column mapping might be wrong, or the supplier put the header on row 3 instead of row 1. Re-open the mapping with a fresh sample and adjust.
• Lots of unmatched SKUs. The supplier's SKU format doesn't match your Shopify SKUs (case, prefix, trailing whitespace). Decide whether to normalise on your side or ask the supplier for a cleaner export.

Stuck? Email us — we reply within one business day and usually faster.