Referral Saasquatch - New v2

_data/taps/schemas/referral-saasquatch/v2/json/referrals.json

@@ -0,0 +1,91 @@
+{
+  "properties": {
+    "dateConverted": {
+      "anyOf": [
+        {
+          "type": "date-time"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "dateModerated": {
+      "anyOf": [
+        {
+          "type": "date-time"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "dateReferralEnded": {
+      "anyOf": [
+        {
+          "type": "date-time"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "dateReferralPaid": {
+      "anyOf": [
+        {
+          "type": "date-time"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "dateReferralStarted": {
+      "anyOf": [
+        {
+          "type": "date-time"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "id": {
+      "properties": {
+        "key": true,
+        "type": "string"
+      },
+      "type": [
+        "object"
+      ]
+    },
+    "programId": {
+      "type": "string"
+    },
+    "referredAccount": {
+      "type": "string"
+    },
+    "referredModerationStatus": {
+      "type": "string"
+    },
+    "referredReward": {
+      "type": "string"
+    },
+    "referredUser": {
+      "type": "string"
+    },
+    "referrerAccount": {
+      "type": "string"
+    },
+    "referrerModerationStatus": {
+      "type": "string"
+    },
+    "referrerReward": {
+      "type": "string"
+    },
+    "referrerUser": {
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

_data/taps/schemas/referral-saasquatch/v2/json/reward_balances.json

@@ -0,0 +1,32 @@
+{
+  "properties": {
+    "accountId": {
+      "properties": {
+        "key": true,
+        "type": "string"
+      },
+      "type": [
+        "object"
+      ]
+    },
+    "amount": {
+      "type": "integer"
+    },
+    "type": {
+      "type": "string"
+    },
+    "unit": {
+      "type": "string"
+    },
+    "userId": {
+      "properties": {
+        "key": true,
+        "type": "string"
+      },
+      "type": [
+        "object"
+      ]
+    }
+  },
+  "type": "object"
+}

_data/taps/schemas/referral-saasquatch/v2/json/users.json

@@ -0,0 +1,75 @@
+{
+  "properties": {
+    "accountId": {
+      "properties": {
+        "key": true,
+        "type": "string"
+      },
+      "type": [
+        "object"
+      ]
+    },
+    "dateCreated": {
+      "anyOf": [
+        {
+          "type": "date-time"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "email": {
+      "type": "string"
+    },
+    "emailHash": {
+      "type": "string"
+    },
+    "emailShareLink": {
+      "type": "string"
+    },
+    "facebookShareLink": {
+      "type": "string"
+    },
+    "firstName": {
+      "type": "string"
+    },
+    "firstSeenIP": {
+      "type": "string"
+    },
+    "id": {
+      "properties": {
+        "key": true,
+        "type": "string"
+      },
+      "type": [
+        "object"
+      ]
+    },
+    "imageUrl": {
+      "type": "string"
+    },
+    "lastName": {
+      "type": "string"
+    },
+    "lastSeenIP": {
+      "type": "string"
+    },
+    "linkedinShareLink": {
+      "type": "string"
+    },
+    "locale": {
+      "type": "string"
+    },
+    "referralSource": {
+      "type": "string"
+    },
+    "shareLink": {
+      "type": "string"
+    },
+    "twitterShareLink": {
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

_data/taps/schemas/referral-saasquatch/v2/referral-saasquatch-v2-foreign-keys.yml

@@ -0,0 +1,84 @@
+tap: referral-saasquatch
+version: '2'
+keys:
+  users_userId:
+  - table: referrals
+    keys:
+    - referredUser
+    - referrerUser
+  - table: reward_balances
+    keys:
+    - userId
+  - table: users
+    keys:
+    - id
+  users_accountId:
+  - table: referrals
+    keys:
+    - referredAccount
+    - referrerAccount
+  - table: reward_balances
+    keys:
+    - accountId
+  - table: users
+    keys:
+    - accountId
+tables:
+- table-name: referrals
+  join:
+  - table-name: reward_balances
+    keys:
+    - key: referredUser
+      foreign-key: userId
+    - key: referrerUser
+      foreign-key: userId
+    - key: referredAccount
+      foreign-key: accountId
+    - key: referrerAccount
+      foreign-key: accountId
+  - table-name: users
+    keys:
+    - key: referredUser
+      foreign-key: id
+    - key: referrerUser
+      foreign-key: id
+    - key: referredAccount
+      foreign-key: accountId
+    - key: referrerAccount
+      foreign-key: accountId
+- table-name: reward_balances
+  join:
+  - table-name: referrals
+    keys:
+    - key: userId
+      foreign-key: referredUser
+    - key: userId
+      foreign-key: referrerUser
+    - key: accountId
+      foreign-key: referredAccount
+    - key: accountId
+      foreign-key: referrerAccount
+  - table-name: users
+    keys:
+    - key: userId
+      foreign-key: id
+    - key: accountId
+      foreign-key: accountId
+- table-name: users
+  join:
+  - table-name: referrals
+    keys:
+    - key: id
+      foreign-key: referredUser
+    - key: id
+      foreign-key: referrerUser
+    - key: accountId
+      foreign-key: referredAccount
+    - key: accountId
+      foreign-key: referrerAccount
+  - table-name: reward_balances
+    keys:
+    - key: id
+      foreign-key: userId
+    - key: accountId
+      foreign-key: accountId

_data/taps/schemas/referral-saasquatch/v2/referral-saasquatch-v2-tables.yml

@@ -0,0 +1,42 @@
+tap: referral-saasquatch
+version: '2'
+tables:
+- name: referrals
+  description: 'The `{{ table.name }}` table contains info about all of the referrals
+    in your {{ integration.display_name }} tenant.
+
+    '
+  links:
+    doc-link: https://docs.referralsaasquatch.com/api/methods/#open_list_referrals
+    singer-schema: https://github.com/singer-io/tap-referral-saasquatch/blob/master/tap_referral_saasquatch/schemas/referrals.json
+    api-method: https://docs.referralsaasquatch.com/api/methods/#list_referrals
+  table-details:
+    replication-method: Key-based Incremental
+    primary-key: id
+- name: reward_balances
+  description: 'The `{{ table.name }}` table contains info about the balances for
+    all rewards.
+
+    '
+  links:
+    singer-schema: https://github.com/singer-io/tap-referral-saasquatch/blob/master/tap_referral_saasquatch/schemas/reward_balances.json
+    api-method: https://docs.referralsaasquatch.com/api/methods#list_balances
+  table-details:
+    replication-method: Key-based Incremental
+    primary-keys:
+    - userId
+    - accountId
+- name: users
+  description: 'The `{{ table.name }}` table contains info about the users in your
+    {{ integration.display_name }} tenant.
+
+    '
+  links:
+    singer-schema: https://github.com/singer-io/tap-referral-saasquatch/blob/master/tap_referral_saasquatch/schemas/users.json
+    api-method: https://docs.referralsaasquatch.com/api/methods#list_users
+  table-details:
+    replication-method: Key-based Incremental
+    primary-keys:
+    - id
+    - accountId
+tap-repo-schemas: true

_data/taps/versions/referral-saasquatch.yml

@@ -2,9 +2,13 @@
 #  REFERRAL SAASQUATCH VERSIONS   #
 # ------------------------------- #
 
-latest-version: "1"
+latest-version: "2"
 
 released-versions:
+  - number: "2"
+    date-released: "Feb 26, 2026"
+    # date-last-connection: ""
+
   - number: "1"
     date-released: "March 1, 2017"
     # date-last-connection:

_includes/integrations/shared-setup/data-selection/data-selection-tabs.html

@@ -72,9 +72,9 @@
 {% capture selection-options %}
 For {{ integration.display_name }} integrations, you can select:
 
-1. **Individual {{ object }}s {% if integration.column-selection == true %} and {{ col }}s{% endif %}**
+1. **Individual {{ object }}s{% if integration.column-selection == true %} and {{ col }}s{% endif %}**
 {% if select-all == true %}
-2. **All {{ object }}s and {{ col }}s** {% if integration.collection == "database-integrations" and view-selection == true %}(except views){% endif %}
+2. **All {{ object }}s{% if integration.column-selection == true %} and {{ col }}s{% endif %}** {% if integration.collection == "database-integrations" and view-selection == true %}(except views){% endif %}
 {% endif %}
 
 {% if view-selection == true %}

_saas-integrations/referral-saasquatch/referral-saasquatch-latest.md → _saas-integrations/referral-saasquatch/v1/referral-saasquatch-v1.md

@@ -1,9 +1,10 @@
 ---
 title: Referral SaaSquatch (v1)
-permalink: /integrations/saas/referral-saasquatch
+permalink: /integrations/saas/referral-saasquatch/v1
 keywords: referral saasquatch, integration, schema, etl referral saasquatch, referral saasquatch etl, referral saasquatch schema
 summary: "Connection instructions and schema details for Stitch's Referral SaaSquatch integration."
 layout: singer
+input: false
 
 key: "referral-saasquatch-setup"
 
@@ -95,4 +96,4 @@ setup-steps:
 # Each table has a its own .md file in /_integration-schemas/referral-saasquatch
 ---
 {% assign integration = page %}
-{% include misc/data-files.html %}
+{% include misc/data-files.html %}