Invite-only membership deep links
When a guest receives an invitation to a private membership, the Webstore uses a specially formatted deep link to deliver them directly to the membership purchase flow. This article explains how invite-only membership deep links work, how the Webstore validates them, and what guests experience when they follow a link.
Audience: Guests who have received an invite-only membership invitation link, and administrators who share or troubleshoot those links.
On this page
- Before you begin
- How invite-only membership deep links work
- Follow a direct invitation link
- Follow a group invitation link
- What happens after you use the link
- Tips
- Troubleshooting
- Related articles
Before you begin
- You need a valid invite-only membership deep link. This link is provided by the business β for example, through a promotional email or a personal invitation from the center.
- The membership the link points to must be active and available for purchase at the time you follow the link.
- If the link requires you to sign in, you need an existing Webstore account or the ability to sign up. For help signing in, see Sign in to your account.
- For membership program setup, see Membership programs.
How invite-only membership deep links work
An invite-only membership is a membership program that is not visible to guests browsing the Webstore normally. A center can make these memberships available only to specific guests by sharing a deep link that contains invitation parameters in the URL.
The Webstore supports two formats of invite-only membership deep links:
| Format | Primary parameter | How the membership is resolved |
|---|---|---|
| Direct invitation | membershipid |
Resolved by Version ID |
| Group invitation | groupinvitemembershipid |
Resolved by Membership ID |
Both formats also use userid and isInvite=true parameters to confirm that the link is a private invitation.
When you open either type of link, the Webstore checks whether the membership it points to is marked as invite-only. If it is, the Webstore takes you directly to the membership purchase flow. If it is not, the Webstore shows an invalid-invitation message and clears the invitation parameters from the URL.
Follow a direct invitation link
Use this procedure when you receive a personal invitation link containing the membershipid parameter.
Open the link
- Open the invitation link from your email or the message where it was shared. The Webstore opens and reads the
membershipid,userid, andisInvite=trueparameters from the URL. - The Webstore checks whether the membership associated with that link is marked as invite-only.
- If the membership is invite-only, the Webstore takes you directly to the membership purchase flow. Continue to the next step.
- If the membership is not invite-only, the Webstore shows an invalid-invitation dialog. The invitation parameters are removed from the URL. No further action is possible with this link β contact the center for a valid invitation.
- Review the membership details presented in the purchase flow.
- If prompted, sign in to your account or sign up to continue.
- Complete checkout to purchase the membership.
Note: The invitation parameters are removed from the URL as soon as the link is processed β whether the invitation was valid or not. If you refresh the page or navigate to another tab and return, the Webstore will no longer recognize the link as an invitation. Complete your purchase in the same session.
Follow a group invitation link
Use this procedure when you receive a group invitation link containing the groupinvitemembershipid parameter. This format is used when a center invites multiple guests to purchase the same membership.
Open the link
Open the group invitation link from your email or the message where it was shared. The Webstore opens and reads the
groupinvitemembershipidparameter from the URL.The Webstore looks up the matching membership using the Membership ID in the link and checks two conditions:
- The membership must be marked as invite-only.
- The membership must be available for purchase.
If both conditions are met, the Webstore navigates you to the membership purchase flow using the membership's Version ID. Continue to the next step.
If either condition is not met, the Webstore shows an invalid-invitation dialog. The invitation parameters are removed from the URL. Contact the center for a valid invitation.
Review the membership details presented in the purchase flow.
If prompted, sign in to your account or sign up to continue.
Complete checkout to purchase the membership.
Worked example: A wellness center runs a members-only recovery program. They send a group invitation link to 50 guests. Each guest opens the link, which contains
groupinvitemembershipid=1042&userid=88901&isInvite=true. The Webstore confirms that membership ID 1042 is invite-only and is available for purchase, then takes each guest to the recovery program purchase screen. A guest who forwards the link to a friend will find that the link works the same way β as long as the membership remains active and invite-only.
What happens after you use the link
After the Webstore processes an invite-only membership link β whether the invitation was valid or not β the invitation parameters (membershipid, groupinvitemembershipid, groupinvitemembershipversionid, userid, and isInvite) are removed from the URL.
This means:
- If you navigate to a different page and return, the invite-only purchase flow will not reopen automatically.
- If you refresh the page after the parameters are removed, the Webstore displays its standard view β the invite-only membership will not appear unless it is also publicly available.
- Complete your membership purchase in the same session before navigating away.
Tips
- Complete your purchase without navigating away. The invitation parameters are removed from the URL as soon as the link is processed. If you leave the page before completing checkout, you will need the original link to restart the process.
- Check your spam or promotions folder. Invitation links are typically delivered by email. If you did not receive a link you were expecting, check your spam or promotions folders before contacting the center.
- Sign in before following the link when possible. Signing in to your account before opening an invitation link can help avoid interruptions during the purchase flow. See Sign in to your account for steps.
- Contact the center if the invitation shows as invalid. If the Webstore shows an invalid-invitation dialog, the link may have expired, the membership may have changed, or the link may have been shared incorrectly. The center can resend a valid invitation.
- Do not alter the link. Invitation links contain multiple parameters that the Webstore validates together. Modifying any parameter β including
userid,isInvite, or the membership identifier β causes the link to fail validation.
Troubleshooting
The Webstore shows an invalid-invitation dialog when I open the link.
The membership the link points to is either not marked as invite-only or is not currently available for purchase. This can happen if:
- The membership program was changed or deactivated after the link was sent.
- The link was modified or copied incorrectly, changing one of the required parameters.
- The link was intended for a different environment (for example, a test or staging link).
Contact the center to request a new invitation link.
The purchase flow opens, but then I see a "Something went wrong" message.
This may occur if your session expired or you lost connectivity during the purchase flow. Close the dialog, return to your original invitation link, and start again. If you no longer have the link, contact the center.
I completed checkout, but the membership does not appear in my account.
After a successful purchase, allow a few moments for the membership to appear in your account profile. If it does not appear after refreshing your profile page, contact the center directly. Do not attempt to purchase the membership again without confirming with the center first, as this may result in a duplicate purchase.
I refreshed the page and the membership purchase flow is no longer visible.
The invitation parameters are removed from the URL after the link is first processed. Refreshing the page removes the context needed to display the invite-only membership. Return to your original invitation link to restart the flow from the beginning.
The link works, but a friend I forwarded it to sees an invalid-invitation dialog.
Group invitation links (groupinvitemembershipid) validate whether the membership is invite-only and available for purchase β they are not restricted to specific guest accounts. If your friend's link shows as invalid, the membership may have become unavailable between when you purchased and when they tried. Ask the center whether the membership is still open for group enrollment.