Welcome to the Heymarvin Developer Documentation Hub
Marvin is a centralized, searchable platform for your team's customer, brand, and market data. Bring data in through the import APIs, or connect your team's tools to Marvin over MCP.
Your team must be on a Pro or Enterprise plan in Marvin to access Marvin's API endpoints.
Start here#
- Access and authorization — create an API key and exchange it for an access token. Every API call needs one.
- Pick a guide for what you're importing — the guides walk the whole flow end to end with runnable code.
- Look up an endpoint in the API reference when you need exact parameters, responses, and status values.
What you can import#
| You have | Guide | Endpoints |
|---|---|---|
| A tabular export — support tickets, CRM records, feedback | Import CSV | CSVs |
| Free text — reviews, verbatims, chat logs, call notes | Import unstructured data | CSVs |
| Survey responses with question types | Import surveys | CSVs |
| Unmoderated research — a CSV plus recordings | Import multimedia CSV | CSVs |
| Audio, video, documents, or images as standalone files | Importing files to Marvin | Files |
| A research document to publish as an insight | Importing insights into Marvin | Insights |
All three need a project to import into. Create one or list the projects you already have.
Other protocols#
- MCP — let an AI client discover and call Marvin tools over JSON-RPC.
- SCIM 2.0 — let your identity provider provision and deprovision Marvin users.
Regions#
Marvin runs in the US and EU. Use the base URL matching your customer's data residency — the two are separate deployments and a token from one is not valid on the other.
| Region | Base URL |
|---|---|
| US | https://app.heymarvin.com |
| EU | https://app.eu.heymarvin.com |
Every code sample in these docs has a tab per region.