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.

Embedding requires two types of integration:

  1. Front-end integration: embed JS code in your UI
  2. Back-end integration: use Peliqan APIs to fetch data from your end-customers

embed.png

<aside> ☝

As an alternative to embedding, you can also use the Peliqan platform UI whitelabeled. Click here for more info on whitelabel.

</aside>

1. Front-end integration (embedding in your UI)

Front-end 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. Click here for a simplified embedding demo.

1.1 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>