# Talkspirit integrations: tasks and tensions

> Create a task, create a tension and add an agenda item in Talkspirit, and start a workflow when Talkspirit sends “Role changed”.

**Canonical page:** https://tray.ai/connectors/talkspirit-integrations/
**Categories:** Operations
**Connects through:** HTTP Connector

## Overview

Talkspirit is a European workplace platform for running an organization's governance, roles, goals, projects and team communication in one place. Tray.ai connects to Talkspirit through the HTTP Connector, so your workflows can call the Talkspirit API alongside the rest of your stack. API access comes through Talkspirit's partner program or API plan, so you need approved credentials first.

## Use cases

### Users

Read and update users in Talkspirit from any Tray.ai workflow. The Talkspirit API covers calls such as list users and get a user.

- List users
- Get a user
- Update a user

### Tasks

Read and create tasks in Talkspirit from any Tray.ai workflow. The Talkspirit API covers calls such as list tasks and get a task.

- List tasks
- Get a task
- Create a task

### Tensions

Read, create, update, and delete tensions in Talkspirit from any Tray.ai workflow. The Talkspirit API covers calls such as list tensions and create a tension.

- List tensions
- Create a tension
- Update a tension

### Meetings

Read and create meetings in Talkspirit from any Tray.ai workflow. The Talkspirit API covers calls such as list meetings and get a meeting.

- List meetings
- Get a meeting
- Add an agenda item

### Circles

Read and update circles in Talkspirit from any Tray.ai workflow. The Talkspirit API covers calls such as list circles and get a circle.

- List circles
- Get a circle
- Update circle custom fields

### Goals

Read goals in Talkspirit from any Tray.ai workflow. The Talkspirit API covers calls such as list goals and get a goal.

- List goals
- Get a goal
- List key results

## Challenges Tray.ai solves

### Keeping Talkspirit credentials out of logs

A raw API call usually means pasting a key or token into the request, where it ends up in step inputs, logs, and screenshots.

**How Tray.ai helps:** Store Talkspirit credentials once as a Tray.ai authentication and reference them from the HTTP Connector. Tray.ai masks authentication values in logs, so the secret never shows up in a step's input or output.

### Going from the Talkspirit API docs to a working call

Translating an example request from API docs into a workflow step means copying the method, URL, headers, and body by hand.

**How Tray.ai helps:** Paste a cURL example from the Talkspirit API docs into the HTTP Connector and Tray.ai fills in the method, URL, headers, and body for you.

### Handling files and non-JSON responses

Not every API answers in JSON. Some return XML, files, or binary data, or expect a multipart upload.

**How Tray.ai helps:** The HTTP Connector parses JSON and XML responses, returns files you can pass to the next step, and sends multipart form data for uploads.

## Frequently asked questions

### Does Tray.ai connect to Talkspirit?

Yes. Tray.ai connects to Talkspirit through the HTTP Connector, which calls the Talkspirit API directly. Any call the Talkspirit API documents can run as a step in a Tray.ai workflow. API access comes through Talkspirit's partner program or API plan, so you need approved credentials first.

### How does Tray.ai authenticate with Talkspirit?

The Talkspirit API uses a bearer token. You save it once as a Tray.ai authentication, and the HTTP Connector adds it to every request.

### Can I get a dedicated Talkspirit connector?

Talkspirit runs through the HTTP Connector rather than a dedicated connector. If your team wants one, the Tray.ai connector SDK can build a dedicated Talkspirit connector from the Talkspirit API.

## Learn more

- Intelligent Integration: https://tray.ai/platform/intelligent-ipaas/
- Merlin Agent Builder: https://tray.ai/platform/merlin-agent-builder/
- Agent Gateway for MCP: https://tray.ai/platform/agent-gateway/
- Book a demo: https://tray.ai/contact/