What you’ll achieve

With Branch configured, this plugin becomes the suite’s Branch link factory:

• Contact invites upgrade automatically. When MAM Main sends a contact invite, the invite link is replaced with a Branch deep link carrying the invite’s id, type, and context — so the invitee lands in the right place in the app even when they had to install it first. Each invite’s link is created once and reused on resends.
• Other plugins can mint links through the mam_universal_link_get_branch_link filter (MAM GeoDirectory uses it for new-listing links).
• Your app build automatically receives the Branch configuration it needs (publishable keys and link domains — the API secrets never leave this site), plus the App Tracking permission message iOS shows.

You’ll need

A Branch.io account (free tier works) with an app configured. Everything below comes from the Branch Dashboard → Account Settings.

Steps

1. Go to Local App Setup → Universal Link → Branch.io Settings.
2. Fill in the live credentials: Branch App ID, Branch Live Key (key_live_…), Branch Live Secret (secret_live_…), and your Default/Alternate Link Domains (e.g. yourapp.app.link).
3. (Optional) Fill in the test app’s id/key/secret and check Use Test Keys while testing. Uncheck it to go live — saving the page with a Branch App ID present resets the toggle unless you re-check it.
4. (Optional) Edit the App Tracking Permission Message — the text iOS shows when the app asks for tracking permission. Blank uses the built-in default.
5. Save. From now on contact-invite links are Branch links; if Branch is unreachable or no key is set, links fall back to the standard invite URL automatically.

Notes

• Links are created server-side against api2.branch.io with a 15-second timeout; failures are logged to the MAM debug log and fall back gracefully.
• Live vs test: the Use Test Keys toggle switches which key mints links sitewide. Test-minted links won’t open the production app.

Related articles

• Hook: mam_universal_link_get_branch_link

Metadata