Typically, we recommend creating a Panora linked user each time a new user is created in your application. We also recommend to import all existing users from your application within Panora. Without doing that, you can’t integrate with Panora.

Using the UI

You can add a single linked user

You can add a batch of linked users by using the drag n drop tool

Currently, we only accept .txt or .csv files that contains your remote ids separated by a comma.

Using our API

This code adds a single/batch of linked accounts inside Panora. It helps us have an exact mapping of your existing users inside our system. These endpoint return Linked Account object(s). Depending on how you architect your system, you might want to store this object’s identifier (id_linked_user) for later use in your database.

 curl --request POST \
     --url https://api.panora.dev/linked-users \
     --header 'Authorization: Bearer <MY_API_KEY>' \
     --header 'Content-Type: application/json' \
     --data '{
         "linked_user_origin_id": "acme_user_1", # your remote id (id representing your existing user inside your system)
         "alias": "acme", # your company name
         "id_project": "ikloqqkq90-djsddhjs-prs12dj",
     }'

How to fetch linked users

You must know how to fetch linked users as you’ll have to use them in the UI widget prop.

Fetch using our library functions

At any point in your code, if you have successfully added your linked users (see above) you’ll be able to fetch them by calling :

  • linkedUserFromRemoteId(remote_id: string) where remote_id is the id of the user inside your system and this function returns a LinkedUser object.
  • fetchLinkedUsers() where this function returns an array of LinkedUser objects for your projectId.
   curl --request GET \
           --url https://api.panora.dev/linked-users/fromRemoteId?remoteId=acme_id_1 \
           --header 'Authorization: Bearer <MY_API_KEY>' \