Matrica
  • Matrica
  • Guides
    • Pricing Guide
    • User Guide
      • Getting Started
      • Linking Wallets
      • Linking Socials
      • Customizing Your Profile
      • Bot Commands
      • Privacy Settings
      • /flash
    • Community Guide
      • Getting Started
      • Manage Community
      • Manage Collections
      • Discord Set-Up
        • Invite the Bot
        • Bot commands
        • Snapshots
      • Verification
        • Adding Rules
        • Fungible Token Roles
        • Amount Based Roles
        • Attribute Based Roles
        • Logic Operators
        • Status Based Roles
        • Verified Collection Roles
        • X Username Gating
        • Wallet Address Gating
        • Validator Stake Gating
        • Inscription # Based Roles
        • Royalty Based Roles
      • Telegram Set-Up
        • Invite the Bot
        • Bot Commands
        • Add Requirements
        • Invite Links
      • Sales Bot and Web-hooks
        • Discord Sales and Listings
        • Telegram Sales
      • Events
        • Create Event
        • Location
        • Requirements
        • Ticketing
      • Proposals
      • Customer Support
      • Staking Support
      • Add-Ons
    • Enterprise
  • Matrica Connect
    • Matrica Connect Overview
    • Who's Building with Matrica Connect?
    • What is OAuth2?
    • Create your application
    • Initial Redirect
    • Retrieving the Access Token
    • API Reference
  • API Reference
    • API - Getting Started
    • Feed
    • User
    • Wallet
    • Events
    • NFT
    • Snapshot
    • Onboard
    • Search
    • Collection
Powered by GitBook
On this page
  • Scopes
  • Button Design
  1. Matrica Connect

Create your application

PreviousWhat is OAuth2?NextInitial Redirect

Last updated 15 days ago

Accessible through your Matrica Business Dashboard at , under the "OAuth2" tab.

Once you are onboarded as a community with Matrica, you will be able to create an application that will allow you to set up the OAuth 2.0 flow.

We recommend using our NPM package for easy integration located at (JS)

Your application can be set as "Public" or "Private". An application is considered "Public" if the flow is started from a public client (such as a mobile app or SPA) which cannot store any confidential data. A "Private" application will be issued a Client Secret which will be required on the authorization and token API calls for extra security.

Your application will have multiple fields related to the OAuth 2.0 flow:

  • Client ID: should be considered public information.

  • Client Secret: only if your app is set to "Private".

  • Redirect URIs: you will need to set your callback URIs, localhost URIs won't be accepted.

  • Scopes: the list of scopes that your application needs and will be asked to the user.

You will also be able to set up a name, description, image and a link to your ToS for your application. This data will be shown to the user on the Authorization screen after triggering the OAuth 2.0 flow.

Scopes

You will need to define the scopes that your application needs. Keep in mind that the lowest amount of scopes you ask for, the most likely the user will accept the OAuth 2.0 authorization. For example, if you ask for their socials and your app only needs their NFTs to operate, the user might refuse to link their account to your application.

Available scopes:

  • profile: Get the user profile information, including username, profile picture and banner, creation date

  • wallets: Get the user 's wallet addresses. Will include cross-chain wallets when they will be available on Matrica (ETH, etc...).

  • nfts: Get the user's NFTs. It's not equivalent to getting the wallets as the user could link multiple wallets without NFTs in them.

  • socials.discord: Get the user's linked discord id.

  • socials.twitter: Get the user's linked twitter id.

  • socials.telegram : Get the user's linked telegram id.

  • email : Get the user's verified email.

Notes:

  • a minimum of one scope must be required by your app.

  • if a scope is scheduled to be removed by Matrica, we will announce a deprecation warning beforehand.

  • more scopes might be added in the future.

Button Design

https://business.matrica.io/apis
https://www.npmjs.com/package/@matrica/oauth-sdk