Set up your first integration
Connect Jira, Google Sheets, Qualtrics, Power BI, or any supported tool so your journey maps show live data from the systems your team already uses.
Plug Jira tickets, Google Sheets numbers, Qualtrics survey results, or any supported tool into Smaply once. Then pull their live data into any journey map in your account.
Prerequisites
You need Admin permissions at the account level. Integrations are configured once for the whole account, not per workspace, and only Admins can set them up.
In this guide
Choose the type of integration you need
Smaply integrations fall into three types. Match your goal to the right one before you go further:
Best for
Showing quantitative data (KPIs, survey results, traffic) on a map
Linking delivery work (tickets, tasks) to the journey it relates to
Pulling in live external content like Figma frames, YouTube, Google Docs
What you see on a journey map
A chart or number card pulling from an external data source
A card showing a live ticket or task from your planning tool
An interactive preview of the external content inside a card
Where you set it up
Account Settings, Integrations tab
Account Settings, Integrations tab
Directly on a card, by pasting a URL
Account-level setup, Admin only?
Yes
Yes
No, any Editor adds one per card
This guide covers the Metrics and Planning integrations you set up in Account Settings. If you want to embed external content, there's nothing to set up at the account level: see How to use embed integrations instead.
Plan availability
On the Free plan, metric, planning, and embed cards are each limited to 3 per map. The Framework plan unlocks unlimited use. Service account authentication for Power BI, Google Analytics, and Excel 365 is a Governance plan feature.
Find the setup guide for your tool
Each tool has its own setup article with the exact fields and credentials it needs. Pick yours from the matching section below.
Connect the integration in Account Settings
Every integration connects in the same place: Account Settings, on the Integrations tab. The connection applies across every workspace in your account, and you only set it up once.
Each tool shows a Set up button when it isn't connected yet, or an Edit button once it is. Most tools need something prepared in the external service first, either an API token (for tools like Jira, Asana, Linear, and Qualtrics) or sign-in to an account with the right access (for the OAuth-based tools). Your tool's setup article lists the exact steps.
For the OAuth-based tools (Google Analytics, Power BI, Google Sheets), you also choose an authentication method when you connect:
Login with your account (OAuth)
Tied to one person and their access to the data. Best for individual connections or quick testing.
Service account
A server-to-server connection, not tied to a specific person. Best for team-wide integrations that shouldn't break when someone leaves.
Service account authentication is available on the Governance plan.
Only one method can be active per integration at a time. After you connect, the tool shows one of these states on the Integrations tab:
Connected, a green banner: the connection is working.
Connection Error, a red banner: the connection failed and needs reconfiguring, usually because credentials are wrong or have expired.
Connection Failed, a red banner: failure caused by something on the external service, for example a plan upgrade required on that tool.
Not configured: the setup form is shown with empty fields.
For switching auth methods, refresh frequency, and what happens on disconnect, see How to manage integrations.
Use your integration on a journey map
How the connected data lands on a map depends on the integration type.
Using a metrics integration is a two-step flow: create a metric, then place it on a map as a metric card. A single metric can be reused across multiple journey maps, and data refreshes on a roughly hourly cycle.
In the metric builder, your connected tool appears in the Source dropdown alongside the other metrics tools.
For the full flow, see:
Planning items live in the connected tool (Jira, Asana, Linear, and so on), not in Smaply. On a journey map, open the Add card menu, choose a planning card, and search for the item you want to link. The card then reflects status changes from the source tool automatically.
For the full flow, see How to use planning cards.
Verify the integration is working
A quick end-to-end check confirms the whole pipeline, from credentials to card display.
For a metrics integration: create a small test metric (for example, a single Number pulling a value you can recognise), add it as a metric card on any journey map, and confirm the card renders with real data. If the card is empty or shows an error, open Account Settings and check that the integration shows as Connected on the Integrations tab.
For a planning integration: add a planning card to a test map, search for a known item in your tool, and confirm the card populates with the expected fields. If the search returns nothing, confirm the integration is still Connected and that the credentials reach the projects you're searching.
If the Integrations tab shows Connection Error or Connection Failed, the credentials have expired or lack the access they need. Re-enter them from your tool's setup article, or check the inline troubleshooting at the bottom of that article.
What's next
Last updated