integrations-lib

Abstracts multiple APIs to give you a shared library to call against different services such as Mail, Calendar, Work Tracking.

• ✅ All communication handled directly from library
• ✅ Promise Based Methods
• ✅ Typescript Bindings
• ✅ Support for Mail, Calendar, Task and Work Tracking
• 😇 Used in Amna

Everything is handled within the library using REST calls and data transformations. It can be an alternate to services such as Nylas or Kloudless.

You may use the library for free, and purchase a one-time access token for complete library usage.

Purchase Here

Free Tier

• 10 function calls per run in Calendar and Mail APIs
• Only checkout 1 Task Service (Google, Todoist, Microsoft) at a time

Docs

See all available methods and interfaces in the Wiki

Usage

import {
  Integrations,
  IntegrationOptions,
  MailServiceType,
} from "integrations-lib"

// after successful oauth, pass in a set of access tokens.
const opts: IntegrationOptions = {
  authorizers: {
    Microsoft: {
      apiToken: "<user access token>",
    },
    Google: {
      apiToken: "<user access token>",
    },
  },
}

const integrations = new Integrations(opts, "DEMO_TOKEN")

const outlook = integrations.getMailService(MailServiceType.Microsoft)
const gmail = integrations.getMailService(MailServiceType.Google)

const draftMessage = {
  to: ["[e-mail]"],
  cc: [],
  bcc: [],
  subject: "Whoa, this library works!",
  body: "Hey, we just sent you and email from our awesome library!",
}

sendMail()

async function sendMail() {
  // send an email
  const gmailResp = await gmail.send(draftMessage)
  const outlookResp = await outlook.send(draftMessage)
}

Authentication

This library does not provide UI for authentication to an OAuth Provider. If you purchased a token, you can purchase our OAuth Helper for Javascript that works with most 3rd party providers.

You can obtain tokens from Google and Microsoft for testing

Interface and API Definitions

All interface definitions can be found in our Public Github Repo

Not all methods have been implemented. There may also be slight variations between two APIs. Please read the wiki.

Open an Issue

Support

Library supporters have the ability to open support tickets. Because we are strapped on resources, we will prioritize token purchasers first.

Open an Issue