# Synthesio integrations

> Call the Synthesio API from any Tray.ai workflow with the HTTP Connector.

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

## Overview

Synthesio, part of Ipsos, is a social listening platform that collects online mentions about brands and topics and adds sentiment, tags and audience data. Tray.ai connects to Synthesio through the HTTP Connector, so your workflows can call the Synthesio API alongside the rest of your stack. API access comes through Synthesio's partner program or API plan, so you need approved credentials first.

## Use cases

### Mentions

Read and update mentions in Synthesio from any Tray.ai workflow. The Synthesio API covers calls such as search mentions and run mention analytics.

- Search mentions
- Run mention analytics
- Update mentions in bulk

### Projects

Read projects in Synthesio from any Tray.ai workflow. The Synthesio API covers calls such as list projects and get a project's topic tree.

- List projects
- Get a project's topic tree

## Challenges Tray.ai solves

### Keeping Synthesio 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 Synthesio 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 Synthesio 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 Synthesio 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 Synthesio?

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

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

The Synthesio API uses OAuth 2.0 and 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 Synthesio connector?

Synthesio runs through the HTTP Connector rather than a dedicated connector. If your team wants one, the Tray.ai connector SDK can build a dedicated Synthesio connector from the Synthesio 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/