Skip to main content

​
Linking Accounts from the Para Modal

After your users sign in, they can view their connected wallets (embedded or external) from the Para Modal’s Profile screen. They will also be able to link addtional third-party accounts or browser wallets through the provided user interface. Linking an account simply requires the user to complete the same steps as for a traditional signup. Depending on the account type, they will be prompted to enter a verification code, complete a third-party signup in a popup, or sign a message with their external wallet. Account Linking To trigger the account linking flow programmatically, you can use the useLinkAccount hook. This will open the Para Modal directly to the account linking interface, and allow you to pre-populate the type and identifier if you choose.
Usage
import { useLinkAccount } from "@getpara/react-sdk@alpha";

const { linkAccount, status, error, isPending } = useLinkAccount();

// To open the modal to the list of account options:
linkAccount();

// To open the modal and display a specific set of options:
linkAccount({
  options: ['EMAIL', 'PHONE', 'GOOGLE', 'TWITTER', 'METAMASK', 'PHANTOM']
});

// To open the modal and display all possible external wallet options:
linkAccount({
  options: ['EXTERNAL_WALLET']
});

// To start linking a pre-determined email address or phone number:
linkAccount({
  auth: { email: 'email@example.com' },
});

linkAccount({
  auth: { phone: '+13105551234' },
});

// To link a user-entered email address or phone number:
linkAccount({
  type: 'EMAIL'
});

linkAccount({
  type: 'PHONE'
});

// To link a third-party account, such as Google or Twitter:
linkAccount({
  type: 'GOOGLE'
});

linkAccount({
  type: 'TWITTER'
});

​
Fetching Linked Accounts

After an account has been linked, you can fetch the linked accounts for the signed-in user via the getLinkedAccounts Para method or the useLinkedAccounts React hook. This call returns their user ID, their primary identifier (the email or phone number they signed up with), and all accounts they have linked thus far. Optionally, you can also retrieve the full profile metadata for each account, in case you want to fetch the Discord, Telegram, X / Twitter handles (for example): 
import { useLinkedAccounts } from "@getpara/react-sdk@alpha";

function App() {
  const { data: linkedAccounts, isLoading, error } = useLinkedAccounts();

  useEffect(() => {
    if (linkedAccounts) {
      // do something with the user's linked accounts
    }
  }, [linkedAccounts])
}

​
Extended Metadata

When fetching linked accounts, you can use the withMetadata option to include the full profile metadata for each account from a third-party service: 
import { useLinkedAccounts } from "@getpara/react-sdk@alpha";

function App() {
  const { data: linkedAccountsWithMetadata, isLoading, error } = useLinkedAccounts({
    withMetadata: true // Set to true to include metadata for linked accounts
  });

  useEffect(() => {
    if (linkedAccountsWithMetadata) {
      const metadata = linkedAccounts.map(({ type, metadata }) => ({ type, metadata }));
      // do something with the user's account metadata
    }
  }, [linkedAccountsWithMetadata])
}
Metadata will only be returned for services that the user authenticated with your app specifically. The particular structure of the metadata will depend on the service in question. A sample response with full metadata included might resemble: 
{
  "userId": "289d4402-bae7-42ff-a0d9-5ec107b41133",
  "primary": [
    {
      "type": "EMAIL",
      "identifier": "google-email@example.com",
      "displayName": "google-email@example.com",
      "date": "2025-06-13T10:30:00Z"
    }
  ],
  "linked": [
    {
      "type": "GOOGLE",
      "identifier": "100000000000000000000",
      "displayName": "google-email@google.com",
      "date": "2025-06-13T10:30:00Z",
      "metadata": {
        "id": "100000000000000000000",
        "emails": [
          {
            "value": "google-email@google.com",
            "verified": true
          }
        ],
        "photos": [
          {
            "value": "https://.../photo.jpg"
          }
        ],
        "provider": "google"
      }
    },
    {
      "type": "DISCORD",
      "identifier": "123456789",
      "displayName": "@DiscordUser#1337",
      "date": "2025-06-13T10:30:00Z",
      "metadata": {
        "username": "DiscordUser",
        "discriminator": "1337",
        "avatar": "8342729096ea3675442027381ff50dfe",
        "verified": true,
        "email": "user@email.com",
        "flags": 64,
        "banner": "06c16474723fe537c283b8efa61a30c8",
        "accent_color": 16711680,
        "premium_type": 1,
        "public_flags": 64,
        "avatar_decoration_data": {
          "sku_id": "1144058844004233369",
          "asset": "a_fed43ab12698df65902ba06727e20c0e"
        }
      }
    },
    {
      "type": "TWITTER",
      "identifier": "171290000000000500",
      "displayName": "@MyXUsername",
      "date": "2025-06-13T10:30:00Z",
      "metadata": {
        "id": 171290000000000500,
        "url": null,
        "lang": null,
        "name": "Test User",
        "email": "user@email.com",
        "id_str": "171290000000000500",
        "entities": {
          "description": {
            "urls": []
          }
        },
        "location": "",
        "verified": false,
        "following": false,
        "protected": false,
        "suspended": false,
        "time_zone": null,
        "created_at": "Fri Oct 13 19:11:38 +0000 2023",
        "utc_offset": null,
        "description": "",
        "geo_enabled": false,
        "screen_name": "MyXUsername",
        "listed_count": 0,
        "friends_count": 0,
        "is_translator": false,
        "notifications": false,
        "statuses_count": 0,
        "default_profile": true,
        "followers_count": 0,
        "translator_type": "none",
        "favourites_count": 0,
        "profile_image_url": "http://pbs.twimg.com/profile_images/171290000000000500/hbDmgt_J_normal.png",
        "profile_link_color": "1DA1F2",
        "profile_text_color": "333333",
        "follow_request_sent": false,
        "contributors_enabled": false,
        "has_extended_profile": true,
        "default_profile_image": false,
        "withheld_in_countries": [],
        "is_translation_enabled": false,
        "profile_background_tile": false,
        "profile_image_url_https": "https://pbs.twimg.com/profile_images/171290000000000500/hbDmgt_J_normal.png",
        "needs_phone_verification": false,
        "profile_background_color": "F5F8FA",
        "profile_sidebar_fill_color": "DDEEF6",
        "profile_background_image_url": null,
        "profile_sidebar_border_color": "C0DEED",
        "profile_use_background_image": true,
        "profile_background_image_url_https": null
      }
    }
  ]
}
⌘I