github icon

App Portal

We extended the visibility we provide you on the Convoy dashboard to your users through app portal, so that your users can view, debug and inspect events sent to them. While the APIs behind app portal are available to build and customize for yourself, we built app portal so you don't have to go through that stress.

convoy app portal

App portal to be usable in three different ways:

  1. As a web component: enabling you to install it into your existing customer application (that's ease). App portal is currently available for two of the most popular Javascript frameworks, Angular and React.
  2. Through a link: you can just open in a new tab and share with a customer quickly. Note: the token expires, i.e the link will be usable for a limited period of time.
  3. Through an iframe: you can embed into a vanilla HTML/Javascript application, copy the iframe code from the dashboard and past in to code.

convoy dashboard app details

App Portal Iframe

As explained above, the iframe url snippet was made available as the easiest to present app portal to your customers. The token embedded into the iframe code expires, so you can use this API to generate a new token whenever your user enters the page with the iframe. Replace the key gotten from the API response with {token}, replace apiURL with your Convoy instance and also replace {appId} with your applications ID in the example below.

iframe snippet
<iframe style="width: 100%; height: 100vh; border: none;" src="{ apiURL }/app-portal/{ token }&appId={ appId }"></iframe>

App Portal Web Components


Adding App Portal to your React application can be done in two steps:

  1. Run npm i convoy-app-react in your existing React application to install the package
  2. Add ConvoyApp to your desired page
import { ConvoyApp } from 'convoy-app-react';
import 'convoy-app-react/dist/index.css';


<ConvoyApp token={'token'} apiURL={'apiURL'} />



You can get started with using App Portal in your Angular application by following these simple steps below:

  1. Run npm i convoy-app in your existing Angular application to install the package
  2. Run ng add @angular/material in your existing Angular application to install angular material
  3. In your package.json, add these under your dependencies:
  "dependencies": {
    "convoy-ui": "^0.0.2",
    "date-fns": "^2.27.0",
    "prismjs": "^1.25.0",
    "chart.js": "^3.6.0",
  1. Run npm install
  2. Add convoy-ui to your styles:
@import '../node_modules/convoy-ui/scss/main.scss';
  1. Import ConvoyAppModule into your application module as shown below
  2. Add ConvoyApp to your HTML page
import { ConvoyAppModule } from 'convoy-app';

    imports: [..., ConvoyAppModule],



<convoy-app [token]="token" [apiURL]="apiURL"></convoy-app>