Introducing Referrals on Tapestry - Tapestry’s Substack

Introducing Referrals on Tapestry

Feb 11, 2025

We're rolling out Referrals so developers can seamlessly track and leverage referral connections within Tapestry. Whether you're building growth loops, rewarding loyal users, or analyzing network effects, you now have the tools to integrate referrals into your app with ease.

How Referrals Work

With Referrals, developers can now:

Pass referral connections into Tapestry when creating or updating a profile.
Retrieve structured referral data, including:
- Who a profile has referred.
- Who referred a given profile.
- Customizable depth for tracing referral chains in either direction.

Developer Features

Seamless Integration: Attach referral relationships during profile creation or updates.
Flexible Querying: Retrieve referral trees with custom depth parameters.
Scalable Tracking: Designed to support deep referral networks efficiently.

Example API Call

Want to see how deep the referral chain goes?

Query:

GET /profiles/{id}/referrals?downstream_depth=2&upstream_depth=4

Response:

{
  "upstreamProfiles": [{ "id": "alice", "depth": 2 }],
  "downstreamProfiles": [{ "id": "bob", "depth": 1 }]
}

See the Docs

Maximizing Network Effects

Referrals are the backbone of organic growth. Whether you’re tracking invites, incentivizing users, or analyzing social graphs, Referrals makes it easy to integrate and scale these systems within your app. Stay tuned for more enhancements in upcoming versions!

We’re always here - reach out with any questions and start integrating referrals into your app today!