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
| App | Kinds of record you can copy | What an action can do in it, once you allow it |
|---|---|---|
| HubSpot | Deals, Companies, Contacts, Tickets and your own custom objects | Change a record, add a note to a record, link two records |
| Attio | Each object in your workspace, such as Companies or People, and each list | Change a record, add a note to a record, add a record to a list |
| Jira Cloud | Projects, and the issues of each project | Change an issue, comment on an issue, link two issues |
| Linear | Issues, Projects, Teams, People, Cycles and Initiatives | Change 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.
- Go to Organisation → Modules → Ontology platform and select Add type.
- Select Connect HubSpot, or the app you want. Organisation → Integrations opens.
- Open the app and select Connect. The app opens.
- 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
- Go back to Organisation → Modules → Ontology platform and select Add type.
- 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.
- Select Look on a kind to see a few of its rows. This is the quickest way to check it’s what you expect.
- Tick each kind you want. One marked Custom is an object your organisation made in the app. One marked Already added is a type already.
- 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_noteon HubSpot. See Set an action’s access and limits. - Your organisation 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.