Documentation Get help

Connect an app and choose what to copy

Bring the records you keep in another app into Flowstate, such as your HubSpot deals. Flowstate reads what’s in the app, shows you a few rows of each kind of record, and copies the kinds you choose. Each one becomes a type. Flowstate keeps the copy up to date as records change in the app.

You need Manage types and links, and access to integrations to connect an app. Ask your Flowstate admin.

What each app offers

AppKinds of record you can copyWhat an action can do in it, once you allow it
HubSpotDeals, Companies, Contacts, Tickets and your own custom objectsChange a record, add a note to a record, link two records
AttioEach object in your workspace, such as Companies or People, and each listChange a record, add a note to a record, add a record to a list
Jira CloudProjects, and the issues of each projectChange an issue, comment on an issue, link two issues
LinearIssues, Projects, Teams, People, Cycles and InitiativesChange an issue, create an issue, comment on an issue

Flowstate only reads from the app when you connect it. See Let an action change things in the app.

Connect the app

Each app connects in one click. You sign in to the app and approve the Flowstate app, with no key or token to copy.

  1. Go to Organization → Modules → Ontology platform and select Add type.
  2. Select Connect HubSpot, or the app you want. Organization → Integrations opens.
  3. Open the app and select Connect. The app opens.
  4. Sign in and approve the Flowstate app’s read-only access. You come back to Flowstate.

You can also start from the app’s own side. Flowstate asks you to sign in and choose the workspace to connect.

Choose what to copy

  1. Go back to Organization → Modules → Ontology platform and select Add type.
  2. Under From an app you’ve connected, select the connection. Flowstate lists the kinds of data it found, with about how many records each holds.
  3. Select Look on a kind to see a few of its rows. This is the quickest way to check it’s what you expect.
  4. Tick each kind you want. One marked Custom is an object your organization made in the app. One marked Already added is a type already.
  5. Select Add 1 type, or Add 3 types if you ticked three.

The new types show under From your apps as Copying. Objects appear on each type’s Objects tab as they arrive, and the type shows Up to date once the first copy has finished.

In our example, you’d tick Deals in HubSpot. The new Deals type comes with the deal’s properties from HubSpot, such as its name, amount and stage.

When you tick HubSpot or Attio deals, or Jira Cloud or Linear projects, Link each record to its Work shows, already ticked. It adds the type with a ready-made setup: its link to Work and the agent that links each record to its Work come with it. See Make an app’s records a source of Work.

Next: say what it means

An app’s property names are often short or cryptic, and some apps send no description at all. Write what the type and each property you rely on mean, so agents read them the way your team does. See Say what a type and its properties mean.

An app property’s name and kind come from the app and can’t be changed here. Its meaning is yours to write.

Let an action change things in the app

When you connect an app, Flowstate asks only for read access. An action can change something in the app only when both of these are true:

  • Its Access tab allows one of the app’s operations, such as create_note on HubSpot. See Set an action’s access and limits.
  • Your organization has allowed Flowstate to change things in that app.

To allow it, open the action’s Access tab and select Allow Flowstate to change things in HubSpot. For HubSpot, Jira Cloud and Linear you sign in to the app again and approve the wider access. Until then, the action shows Waiting for access to an app and doesn’t run.

If something’s not right

An app says it can’t be connected in this region yet. Your Flowstate workspace’s region doesn’t offer that app yet. Talk to your Flowstate account manager.

Flowstate found nothing to copy. Usually the account that connected the app can’t see any records. Sign in to the app again with an account that can.

A kind says “Flowstate can’t copy this yet”. Flowstate can’t read that kind of record from the app, so it can’t be ticked.

A type shows “HubSpot is limiting requests”. The app has asked Flowstate to slow down. Flowstate waits and carries on by itself.