How integrations work

Credentials, test buttons, webhooks and what to connect first.

Everything that talks to an outside service is connected under Integrations. They all work the same way, so it is worth reading this once before doing any of them.

How every integration works

  1. Create an account with the service and get credentials from their console.
  2. Paste them into the integration card in your store.
  3. Press Test. It makes a real call and tells you whether the credentials are actually accepted — not merely that you typed something.
  4. If the service pushes events back to you, copy the webhook URL from the card into their console.

Copy webhook URLs from the card, do not type them. They are shown on the integration page for exactly this reason. A URL that is one character wrong fails silently — the other service thinks it delivered, and you never hear anything.

Secrets are write-only

  • Once saved, a password or key is never shown back to you.
  • Leaving a secret field blank means keep the current value, not "clear it".
  • Store the original somewhere safe when you first generate it. Most services show a secret once and never again.

What to connect, and when

IntegrationWhenWithout it
RazorpayBefore launchNobody can pay
Email (SMTP)Before launchNo order confirmations
ShiprocketBefore your first shipmentBook couriers manually elsewhere
Meta Pixel & GA4Before you spend on adsNo idea which ad sold anything
WhatsAppOnce orders are flowingNo order updates or cart recovery on WhatsApp
InstagramIf you sell through InstagramDMs stay in the Instagram app
AIAny time, optionalEverything works, minus the AI features
Storage & CDNWhen images get heavyImages served from the store's own disk
Claude / ChatGPTAny time, optionalNo plain-language questions of your own data

Test buttons tell you the truth

A test that passes means the credentials were accepted right now. It does not prove the webhook works — that only happens when a real event fires. For anything with a webhook, do the real thing once: place an order, send yourself a message, ship a parcel.

When one stops working

SymptomUsual cause
Worked yesterday, not todayA temporary token expired. Most services issue one during setup that lasts hours.
Test passes, nothing arrivesThe webhook URL is wrong, or was never set.
Test fails immediatelyWrong key, or the account is not approved yet.
IntermittentRate limits, or the service is having an outage. Check their status page before debugging.

Still stuck? Message us on WhatsApp — we would rather answer than have you guess.