mongrl sends the emails (sign-in links, confirmations, order and message notices), and their links point at your storefront. Build these pages, or the links lead nowhere.
Set the shop’s address first
Section titled “Set the shop’s address first”In the console, Settings → Shop and emails: the marketplace’s team sets the shop’s address (e.g. https://www.example.com) and who emails come from. Until the address is set, mongrl can’t send emailed links: requesting one gives 409.
The pages
Section titled “The pages”<lang> is the user’s language, lower-case (sv, en): their locale, or the marketplace’s default.
| Page | Linked from | What it does |
|---|---|---|
/<lang>/auth/sign-in?token=… |
Sign-in links, welcome emails | POST /v1/sessions/from-link with the token, store the session, go on to the account. |
/<lang>/auth/verify-email?token=… |
Sign-up, “send it again” | POST /v1/email-verifications with the token, then say it’s confirmed. |
/<lang>/auth/reset-password?token=… |
Password reset emails | Ask for a new password, POST /v1/password-resets/confirm, then sign in. |
/<lang>/orders/<order id> |
Order emails to buyers and sellers | Sign in if needed, then GET /v1/me/orders/{id}: state, timeline, buttons from available_transitions, delivery booking. |
/<lang>/messages/<conversation id> |
New message emails | Sign in if needed, then the conversation. |
/<lang>/account/listings/<listing id> |
Valuation offers, denials, listings put on sale | Sign in if needed, then GET /v1/me/listings/{id}: the offer to accept or answer, the reason it was denied, or that it’s on sale. |
Tokens in links work once. If the page loads twice (a mail scanner, a double click), the second try gets 422: say the link has been used and offer a new one.
If your shop doesn’t use language prefixes
Section titled “If your shop doesn’t use language prefixes”Redirect them. A shop in one language can send /en/… to /… and keep the query string, so every emailed link still lands.
Everything else is yours
Section titled “Everything else is yours”Shop, search, listing, brand and designer pages, checkout, the account, selling: their addresses are up to you. Keep them stable, because listing URLs get shared and indexed.