Connect to your users' accounts

Setup Guide

You can find your app credentials by visiting your account.

You'll need the following information to set up your app with Paragon:

  • API Key

Getting your API Key

  1. Go to your account.

  2. Click the Account icon in the bottom-left corner

  3. Select Administration

  4. Select "Connections"

  5. Select "API" from the top sidebar.

  6. Copy the API Key under Personal API Token.

Connecting to

Once your users have connected their account, you can use the Paragon SDK to access the API on behalf of connected users.

See the REST API documentation for their full API reference.

Any API endpoints can be accessed with the Paragon SDK as shown in this example.

// You can find your project ID in the Overview tab of any Integration

// Authenticate the user
paragon.authenticate(<ProjectId>, <UserToken>);
// Query Items
await paragon.request("", "/", { 
  method: "POST",
  body: {"query":"query { items (ids: [157244624, 201781760, 239164869]) { name } }"}

// Create an item
await paragon.request("", "/", { 
  method: "POST",
  body: {"query":"mutation { create_item (board_id: 1234567, group_id: \"today\", item_name: \"new item\") { id }}

Building workflows

Once your account is connected, you can add steps to perform the following actions:

  • Create Item

  • Update Item

  • Get Item by ID

  • Get Item by External ID

  • Search Items

  • Delete Item

  • Archive Item

  • Create Subitem

  • Search users

When creating or updating items in, you can reference data from previous steps by typing {{ to invoke the variable menu.

Using Webhook Triggers

Webhook triggers can be used to run workflows based on events in your users' account. For example, you might want to trigger a workflow whenever items are updated to sync your users' items to your application in real-time.

You can find the full list of Webhook Triggers for below:

  • Item Created

  • Item Updated Trigger when items have either a name change or a column value change.

Last updated