# Introducing Referrals on Tapestry

[Tapestry](https://substack.com/@usetapestry)

Feb 11, 2025

We're rolling out [Referrals](https://docs.usetapestry.dev/api#tag/profiles/GET/profiles/{id}/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:**
```plaintext
GET /profiles/{id}/referrals?downstream_depth=2&upstream_depth=4
```
**Response:**
```json
{
  "upstreamProfiles": [{ "id": "alice", "depth": 2 }],
  "downstreamProfiles": [{ "id": "bob", "depth": 1 }]
}
```

[See the Docs](https://docs.usetapestry.dev/api#tag/profiles/GET/profiles/{id}/referrals)

### 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!