> ## Documentation Index
> Fetch the complete documentation index at: https://docs.proofage.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Sharetribe: send the verification link

> Step 1 of 2 for Sharetribe: get your Integration API keys, create a ProofAge test workspace and build the Zap that emails each new user a verification link.

This page is the first of two steps. Here you prepare your marketplace and ProofAge, and build
the Zap that sends each new user a verification link, with no manual work from you.
[Grant access after verification](https://docs.proofage.net/integration/sharetribe/grant-access.md)
then builds the Zaps that act on the result. For the big picture, read the
[overview](https://docs.proofage.net/integration/sharetribe/overview.md) first.

## What you need

### Accounts

* **Zapier account.** Sign up at [zapier.com](https://zapier.com). You need the Professional
  plan for Zaps with more than two steps. A new account starts on the Free plan: go to
  **Settings → Billing & usage** and click **Try Pro for 14 days** to start the free trial. No
  card is needed. When the trial ends, Zaps with more than two steps stop running unless you
  upgrade.

  ![Zapier, Settings → Billing & usage after starting the trial: Pro plan, Trial, with the trial end date](https://mintcdn.com/proof-age/gLg3IDPZozTL8Ct8/images/sharetribe/02-00-zapier-pro-trial.png?fit=max\&auto=format\&n=gLg3IDPZozTL8Ct8\&q=85\&s=4c53d75e0e4a6f646768b74f1563fad2)
* **ProofAge account.** Sign up at [app.proofage.net](https://app.proofage.net). New accounts get free
  trial verifications ([Pricing](https://docs.proofage.net/getting-started/pricing.md)), and test workspaces are always free.
* **An email account connected to Zapier**, such as Gmail. This guide uses Gmail.

### Your marketplace setup

Do these in your marketplace's **Test** environment.

**Access control.** Decide what new users can't do until they are verified. In Console, go to
**Build → General → Access control**. This guide ticks all three of these, so that the next page
shows both ways of granting access:

* **Approve users who want to join**: new users can't do anything until they are approved.
* **Restrict posting rights**: new users can't post listings.
* **Restrict transaction rights**: new users can't start transactions.

Leave **No call to action** selected under each, and click **Save changes**. On your own
marketplace, tick only the options you need.

![Sharetribe Console, Build → General → Access control: the three options ticked, with No call to action selected under each](https://mintcdn.com/proof-age/gLg3IDPZozTL8Ct8/images/sharetribe/02-01-access-control.png?fit=max\&auto=format\&n=gLg3IDPZozTL8Ct8\&q=85\&s=8c6a88e80a0b77c9c5e66c8d2bab9c8b)

**Two content pages.** Create these two pages:

| Page ID | Section title | Section description (example) |
| - | - | - |
| `verification-received` | Thanks, we've got it! | We've received your identity verification. You'll get an email with the result, usually within a few minutes. |
| `verification-failed` | We couldn't verify your identity | Your identity verification didn't go through. Reply to the email we sent you, or write to [team@example.com](mailto:team@example.com), and we'll send you a new link to try again. |

For each page:

1. In Console, go to **Build → Content → Pages** and click **+ Create a new page...**.
2. Enter the **Page ID** from the table and click **Create page**.
3. Click **Edit content** under the new page, then **+ Add a new section**.
4. Enter a **Section name**. Only you see it.
5. Choose the **Hero** template.
6. Enter the **Section title** from the table and select **Page title (H1)**.
7. Enter the **Section description**.
8. Click **Save changes**.

![Sharetribe Pages editor, verification-received page: Hero template, Section title, Page title (H1) and Section description](https://mintcdn.com/proof-age/gLg3IDPZozTL8Ct8/images/sharetribe/02-02-page-received.png?fit=max\&auto=format\&n=gLg3IDPZozTL8Ct8\&q=85\&s=4b36710b4c759a2103d73413b458bdaf)

Click **View page** to see the page. Its address is your marketplace address followed by
`/p/` and the page ID, for example `https://your-marketplace.com/p/verification-received`.
In the Test environment the address ends in `.mysharetribe-test.com`.

Copy the addresses of both pages. You'll need them below.

**A test user.** Sign up on your Test marketplace as a new user, with an email address whose
inbox you can open. You'll use this user to test the Zap. If you set up approval to join, don't
approve this user yourself: the Zap on the next page will do it.

## Getting your Integration API keys from Console

Zapier connects to your marketplace with Integration API keys. In Sharetribe Console, in your
Test environment:

1. Go to **Build → Advanced → Applications**.
2. Click **+ Add a new application**.
3. Name it (for example "Zapier"), select **Integration API** and click **Add application**.
4. Copy the **Client ID** and **Client Secret** to a safe place, such as a password manager.

![Sharetribe Console, Build → Advanced → Applications: the Zapier Integration API application with its Client ID and Client Secret (values blurred)](https://mintcdn.com/proof-age/gLg3IDPZozTL8Ct8/images/sharetribe/02-03-integration-api-app.png?fit=max\&auto=format\&n=gLg3IDPZozTL8Ct8\&q=85\&s=7e871395be4b36a235e990a61f5bab4e)

> [!WARNING]
>
> The Client ID and Client Secret work like a password to your marketplace data. Console shows the full secret only once, right after you add the application; later it shows only the last characters. If you lose it, create a new application.

## Setting up ProofAge

### Create a test workspace

1. Sign in to [app.proofage.net](https://app.proofage.net), go to **Workspaces** and click
   **Create workspace**.

2. Enter a **Name**, for example "Sharetribe Zapier".

3. Under **What should this workspace check?**, choose:

   * **Identity (KYC)**: the user scans an ID document and takes a selfie. Pick this to know
     who your users are.
   * or one of the **Age verification** options (**Digital ID wallet**, **ID document** with a
     minimum age, or **Facial age estimation**) if you only need to know that users are old
     enough.

   You can't change this later, so create another workspace if you change your mind.

4. Under **Mode**, select **Test**. The form selects **Live** by default.

5. Click **Create Workspace**.

   ![ProofAge console, Create workspace form: Identity (KYC) and Test selected, and the Create Workspace button](https://mintcdn.com/proof-age/gLg3IDPZozTL8Ct8/images/sharetribe/02-04-proofage-test-workspace.png?fit=max\&auto=format\&n=gLg3IDPZozTL8Ct8\&q=85\&s=def22bb69ac7c4fdd8a135e0124be58c)

6. On the workspace page, open the **Integration URLs** tab and paste the address of your
   `verification-received` page into **Redirect URL**. It saves when you leave the field.

   Your Zap will set this address itself. The workspace setting is for links you create by hand
   in the ProofAge console, which the next page uses to
   [let a user try again](https://docs.proofage.net/integration/sharetribe/grant-access.md#let-a-user-try-again).

   ![ProofAge console, workspace Integration URLs tab with the Redirect URL filled in (marketplace name blurred)](https://mintcdn.com/proof-age/gLg3IDPZozTL8Ct8/images/sharetribe/02-04b-proofage-redirect-url.png?fit=max\&auto=format\&n=gLg3IDPZozTL8Ct8\&q=85\&s=adfe69463efa873193fa33d56d16837d)

In a [test workspace](https://docs.proofage.net/integration/sandbox-testing.md) nothing is charged and no verification is
decided automatically: you choose each result yourself in the ProofAge console. That's how
you'll test every scenario on the next page without a real ID.

### Add ProofAge to your Zapier account

The [ProofAge app for Zapier](https://docs.proofage.net/integration/zapier.md) is in beta and available through an invite link:

1. Open [this invite link](https://zapier.com/developer/public-invite/247468/5e5e57c63024eb4242e4cad2e9d37dcf/) while signed in to Zapier.
2. Click **Accept Invite & Build a Zap**. Zapier takes you to your Zaps page.

![Zapier invite page for ProofAge with the Accept Invite & Build a Zap button highlighted](https://mintcdn.com/proof-age/gLg3IDPZozTL8Ct8/images/sharetribe/02-05-zapier-invite.png?fit=max\&auto=format\&n=gLg3IDPZozTL8Ct8\&q=85\&s=d8fa87bc1372e88f79aeadfbecd248d7)

The invite page says that Zapier hasn't reviewed the app yet. Zapier shows this for every
invite-only app.

You only do this once. ProofAge now appears when you search for apps in the Zap editor.

## Creating the Zap, step by step

In Zapier, click **+ Create** and choose **Zaps**. Then click the new Zap's name ("Untitled
Zap") at the top, choose **Rename** and name it **ProofAge 1 – Send verification link**.

### Step 1: User created trigger

1. As the trigger app, choose **Sharetribe**. As the trigger event, choose **User Events**.

2. Connect your marketplace: click **Sign in** and paste the Client ID and Client Secret from
   above. Make sure you use the keys of your **Test** environment.

   ![Zap 1 trigger, Setup tab: app Sharetribe, trigger event User Events, the connected marketplace account](https://mintcdn.com/proof-age/gLg3IDPZozTL8Ct8/images/sharetribe/02-06-zap1-trigger.png?fit=max\&auto=format\&n=gLg3IDPZozTL8Ct8\&q=85\&s=f5ce8d4dd56dfd3035d38477cdcdcb94)

3. In **Configure**, set the event type to **User created**.

   ![Zap 1 trigger, Configure tab: Event type = User created](https://mintcdn.com/proof-age/gLg3IDPZozTL8Ct8/images/sharetribe/02-06b-zap1-trigger-event-type.png?fit=max\&auto=format\&n=gLg3IDPZozTL8Ct8\&q=85\&s=cea15f6c83d0ae2c3db0c6153d742370)

4. Click **Test trigger**. Zapier should find your test user and show a record such as
   "User event A". If it finds nothing, sign up a new user on your marketplace and test again.

   ![Zap 1 trigger test: a user created record with User Id and User Email highlighted (values blurred)](https://mintcdn.com/proof-age/gLg3IDPZozTL8Ct8/images/sharetribe/02-07-zap1-trigger-test.png?fit=max\&auto=format\&n=gLg3IDPZozTL8Ct8\&q=85\&s=9519a51f2002a96362f13683057ffe0a)

### Step 2: Create the verification in ProofAge

1. Add an action step. Search for **ProofAge** (Zapier lists it as "ProofAge (2.0.0)" with an
   **Invite Only** label) and choose **Create Verification** as the event.

2. Connect ProofAge:

   1. Click **Sign in**. A window opens.
   2. Zapier first asks you to confirm. Click **Connect**.
   3. Sign in to ProofAge if asked.
   4. Choose your **test workspace** (it's marked **Test**) and click **Allow**.

   ![ProofAge consent screen: the test workspace selected and the Allow button highlighted](https://mintcdn.com/proof-age/gLg3IDPZozTL8Ct8/images/sharetribe/02-08-proofage-connect.png?fit=max\&auto=format\&n=gLg3IDPZozTL8Ct8\&q=85\&s=8ef61e7c441f33192a369b947e85d0e5)

   The connection appears in Zapier as "*Your workspace name* (Test)".

   > [!NOTE]
   >
   > Only ProofAge administrators and developers can connect a workspace. ProofAge creates a key named "Zapier · …" in the workspace for this connection; deleting that key disconnects Zapier.

3. In **Configure**, fill in:

   * **External Reference:** click **+** next to the field and choose **User Id** from step 1.
     This is how ProofAge's result is matched back to the right user, so don't type anything
     else here.
   * **Redirect URL:** the full address of your `verification-received` page.
   * **Language:** leave empty to use the language of the user's browser, or choose one.
   * **Metadata:** leave empty.

   ![Create Verification, Configure tab: External Reference = 1. User Id (an arrow marks the + button), Redirect URL filled in](https://mintcdn.com/proof-age/gLg3IDPZozTL8Ct8/images/sharetribe/02-09-zap1-create-verification.png?fit=max\&auto=format\&n=gLg3IDPZozTL8Ct8\&q=85\&s=1be86b397bd5196441d0b28f678ee9c1)

4. Click **Test step**. In the result you'll find **Verification URL**: the link the user opens
   to verify. You'll use it in the next step.

   ![Create Verification test result with the Verification URL highlighted (link blurred)](https://mintcdn.com/proof-age/gLg3IDPZozTL8Ct8/images/sharetribe/02-10-zap1-create-verification-test.png?fit=max\&auto=format\&n=gLg3IDPZozTL8Ct8\&q=85\&s=759324a044cf89ec98ccf1290eaa7bb7)

The checks themselves (ID and selfie, or age) come from the ProofAge workspace you connected,
so there's nothing else to configure here.

### Step 3: Email the link to the user

1. Add an action step with **Gmail** (or your email app) and choose **Send Email**. Connect the
   mailbox you want users to see and reply to, such as your marketplace's support address: the
   email is sent from it.

2. **To:** choose **User Email** from step 1.

3. **Subject:** for example `Your Marketplace: please verify your identity`.

4. **Body:** for example, inserting the fields in brackets from steps 1 and 2:

   > Hi \[1. User Profile First Name], and welcome to Your Marketplace! Before you can start
   > using your account, please verify your identity. It takes about two minutes and you'll
   > need your ID document and your phone's camera: \[2. Verification URL]
   >
   > The link is valid for 7 days. If you have any questions, just reply to this email.
   >
   > – The Your Marketplace team

   ![Gmail Send Email step: To = 1. User Email, Subject, and the Body with the first name and Verification URL inserted](https://mintcdn.com/proof-age/gLg3IDPZozTL8Ct8/images/sharetribe/02-11-zap1-email.png?fit=max\&auto=format\&n=gLg3IDPZozTL8Ct8\&q=85\&s=8dbd5489fa4d3cd3dbec0b821e630fca)

5. Click **Test step** and check that the email arrives in the test user's inbox.

   ![The verification email as received by the test user (addresses and link blurred)](https://mintcdn.com/proof-age/gLg3IDPZozTL8Ct8/images/sharetribe/02-12-zap1-email-received.png?fit=max\&auto=format\&n=gLg3IDPZozTL8Ct8\&q=85\&s=db6cb86be378588b0abf119d22d04286)

6. Click **Publish** to turn the Zap on.

## What the user sees

The user opens the link from the email. On a phone, the first screen says what's ahead (a photo
of their ID, then a selfie) and asks them to agree before the camera starts:

![The first ProofAge screen on a phone: Verify your identity, the two steps, and Agree and continue](https://mintcdn.com/proof-age/gLg3IDPZozTL8Ct8/images/sharetribe/02-13-user-flow-phone.png?fit=max\&auto=format\&n=gLg3IDPZozTL8Ct8\&q=85\&s=2230b8cc1bafca899d68f2e32c6f0ff4)

On a computer, the first screen shows a QR code to continue on the phone, or a link to carry on
in the browser:

![The first ProofAge screen on a computer: a QR code to continue on the phone (QR code blurred)](https://mintcdn.com/proof-age/gLg3IDPZozTL8Ct8/images/sharetribe/02-13b-user-flow-desktop.png?fit=max\&auto=format\&n=gLg3IDPZozTL8Ct8\&q=85\&s=15148268ae6a24b7e9bd281133ede64c)

After the last screen, the user lands on your `verification-received` page.

![The marketplace's verification-received page after the last screen](https://mintcdn.com/proof-age/gLg3IDPZozTL8Ct8/images/sharetribe/02-14-user-received-page.png?fit=max\&auto=format\&n=gLg3IDPZozTL8Ct8\&q=85\&s=7e513a974e7aee15ba2ad2919242a0fc)

In a test workspace, the finished verification now waits for you to choose its result. That's
where the next page begins.

## Next

Every new user now gets a verification link automatically. Next, build the Zaps that act on
the result: [Grant access after verification](https://docs.proofage.net/integration/sharetribe/grant-access.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.