Overview
Nuclino is a unified workspace for team knowledge, documentation, and projects. Persona’s Nuclino integration lets you list teams and workspaces, search and retrieve items, and create items or collections from a Workflow.
Integration features
The Nuclino integration supports these Workflow actions:
- List teams: Retrieve the teams available to the authenticated user.
- List workspaces: Retrieve accessible workspaces.
- List or search items: Retrieve items and collections within a team or workspace.
- Create item: Create an item or collection.
- Get item: Retrieve an item or collection, including its content.
Prerequisites
Before configuring the integration, you need:
- A Nuclino account.
- A Nuclino API key.
- Access to the teams, workspaces, and items you want to use.
Set up Nuclino credentials
- In Nuclino, open Account > Settings > API keys and create an API key.
- In the Persona Dashboard, go to Integrations > Marketplace and select Nuclino.
- Select Add Credential and enter a nickname and the API key.
- Save the credential.
Nuclino sends the API key as the raw value of the Authorization header, without a Bearer prefix. The key has the permissions of the user who created it.
Use Nuclino in a workflow
- Create a workflow or open the workflow you want to update.
- Add an Action step and select Integrations.
- Select Nuclino, choose the saved credential, and select an action.
- Map Persona data to the action inputs.
- Save and publish the workflow.
Nuclino actions
List teams and workspaces
List teams to find a Team ID, then list workspaces to find a Workspace ID. You can optionally filter workspaces by Team ID.
List or search items
List items and collections in a workspace or team. Provide either a Workspace ID or a Team ID, not both. Add a search query to return matching items ordered by relevance. List results do not include item content; use Get item for the full item.
Create item
Create an item or collection.
Required location:
- Workspace ID or Parent Collection ID: Provide one location, not both.
Optional fields include:
- Object type: Item or collection.
- Title: The item title.
- Content: Markdown content for an item.
- Position: The zero-based position within the parent.
Get item
Use an Item ID to retrieve an item or collection. Item responses include content in Markdown format; collection responses include their child item IDs.
Plans Explained
Nuclino integration by plan
| Startup Program | Essential Plan | Growth Plan | Enterprise Plan | |
|---|---|---|---|---|
| Nuclino integration | Not Available | Available | Available | Available |