SaaS companies can embed Peliqan widgets into their own product, in order to offer a wide range of connectors inside their own SaaS platform. The embedding is seamless and offers your end-customers a user-friendly UI to add connections to other platforms that they use, right from within your SaaS platform.

Once your customer added a connection, data is automatically synced to Peliqan and you can access the data through Peliqan's unified API, without the need to communicate directly to hundreds of different APIs. Instead, with a single integration, you can enable integrations between your SaaS platform and hundreds of other SaaS platforms such as ERP, CRM, Accounting, HRM & ATS, PIM, eCommerce etc.

embed.png

Embedding

Embedding is performed in 2 steps:

  1. Fetch an integration_token for a specific end-customer. You identify the end-customer using the external_id which is your unique id for the customer.
  2. Add JS code into your product that renders e.g. a button "Add connection". When the button is clicked, a JS function is invoked that opens a modal, in which the user can choose and add a connection.

Embedding step 1: fetch an integration_token

Make a server-side API call to fetch a short-lived (30 min) integration_token for a specific end-customer using your unique customer ID (external_id in Peliqan):

POST <https://app.eu.peliqan.io/api/partner/sub-account/integrate/>

Note: the trailing slash at the end of the URL is required !

Authorization: JWT <partner_token>

Request Payload

{
    "external_id": user.id,  # unique entity ID
    "first_name": user.first_name,
    "last_name": user.last_name,
    "email": user.email,
    "company_name": user.organization.name, # your user's organization name
}

Embedding step 2: add the Peliqan widget in your own UI

Add inside the <head> tag of your UI:

<script type="module" src="<https://peliqan.io/embed/v1.1/peliqan-integration.js>"></script>