---
updatedAt: 2026-06-16T08:31:17.000Z
agentTools:
  projectIndex: https://loyaltyapi.yotpo.com/llms.txt
---

# Referral Product Share Link

If you're using an ESP to send referral share emails, you can use this event to trigger the product share referral email.

<Table align={["left","left"]}>
  <thead>
    <tr>
      <th style={{ textAlign: "left" }}>
        Important Attributes
      </th>

      <th style={{ textAlign: "left" }}>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td style={{ textAlign: "left" }}>
        `email`
      </td>

      <td style={{ textAlign: "left" }}>
        The email of the referred friend
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        `from`
      </td>

      <td style={{ textAlign: "left" }}>
        The email of the referring customer
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        `customer.first_name`
      </td>

      <td style={{ textAlign: "left" }}>
        The name of the referring customer
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        `product_referral_link`
      </td>

      <td style={{ textAlign: "left" }}>
        The referring customer's unique product referral link for this specific product
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        `product_id`
      </td>

      <td style={{ textAlign: "left" }}>
        The product ID of the shared product
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        `product_name`
      </td>

      <td style={{ textAlign: "left" }}>
        The name of the shared product
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        `image_url`
      </td>

      <td style={{ textAlign: "left" }}>
        The shared product's image URL
      </td>
    </tr>
  </tbody>
</Table>

```json
{
  "topic": "loyalty/referral/product_share",
  "name": "Loyalty Referral Product Share",
  "website_url": "http://example.myshopify.com",
  "email": "person@gmail.com",
  "from": "example@test.com",
  "customer": {
    "total_spend_cents": 24200,
    "total_purchases": 1,
    "perks_redeemed": 3,
    "last_purchase_at": "2021-06-01T07:02:40.000Z",
    "first_name": "Name",
    "last_name": "Name",
    "is_member": false,
    "accepts_marketing": false,
    "email": "example@test.com",
    "referred_by": "jane.smith@gmail.com",
    "points_balance": 2620,
    "points_earned": 2620,
    "last_seen_at": "2021-06-01T07:03:11.000Z",
    "thirty_party_id": "5205258371095",
    "third_party_id": "5205258371095",
    "referral_link": "http://rwrd.io/9code7",
    "referral_discount_code": "YOTPO-TEST162",
    "is_opt_in": true,
    "loyalty_opt_in_date": "2021-06-01",
    "has_store_account": false,
    "credit_balance": "$2,620",
    "credit_balance_in_customer_currency": "$2,620",
    "is_affiliate": false,
    "points_expire_at": "2021-08-30T07:03:11.000Z",
    "vip_tier_name": "zzzz",
    "vip_tier_ends_at": "2022-06-01",
    "referral_code": {
      "code": "9eko7c7",
      "shares": 1,
      "facebook_shares": 0,
      "twitter_shares": 0,
      "email_shares": 1,
      "emails_sent": 0,
      "emails_viewed": 0,
      "links_clicked_from_email": 0,
      "links_clicked_from_twitter": 0,
      "links_clicked_from_facebook": 0,
      "orders": 0,
      "amount_cents": 0,
      "average_amount_cents": 0,
      "expires_at": null,
      "expired": false,
      "completed_referral_customers": [],
      "email": "example@test.com",
      "unique_clicks": 0,
      "total_clicks": 0
    }
  },
  "referral_link": "http://rwrd.io/9code7",
  "referral_code": "9code7",
  "product_referral_link": "http://rwrd.io/9code7?e&pid=10077553923",
  "product": {
    "id": "10077553923",
    "name": "Amazing product",
    "image_url": "https://cdn-yotpo-images-production.yotpo.com/Product/34280041/27894349/thumb.jpg?1572908368"
  },
  "referral_discount_code": "YOTPO-TEST162"
}
```