Question 1

What integration options does empirio.ai offer?

Accepted Answer

empirio.ai can be connected to other systems in four ways:

* REST API – Manage surveys and retrieve responses via HTTPS.
* Webhooks – Push new responses to your own system in real time.
* MCP server – Let AI agents like ChatGPT or Claude work directly with your surveys and responses.
* CLI – The command-line tool @empirio-ai/cli for scripts, automations, or quick actions from the terminal.

All integrations are currently in beta – endpoints and behavior may still change.

You can find more information at https://www.empirio.ai/integrations, including complete developer documentation.

Question 2

Who are the integrations for?

Accepted Answer

For everyone who doesn’t just want to use empirio.ai via the web interface, but also wants to integrate it into their own systems or workflows. Typical use cases:

Developers who want to create surveys automatically or transfer responses into their own tools (CRM, data warehouse, BI tools).

Companies that want to feed survey responses directly into internal systems – for example, send a Slack message after each response or pass data into reporting.

Data analysts who regularly process responses further in SPSS, R, or Python and want to automate exports.

Teams that work with AI agents and want to give their agents direct access to empirio.ai – via the MCP server.

Question 3

Which plan do I need for the integrations?

Accepted Answer

The integrations are available starting with the Pro plan. For extensive or company-wide use, there is also an Enterprise plan with higher limits and additional terms. To learn more, please contact the support team at info@empirio.ai

Question 4

What is the REST API and what do I need it for?

Accepted Answer

The REST API is the classic interface for programmatic survey management. Over HTTPS you can:

* Create, edit, publish, duplicate, and delete surveys
* Retrieve, filter, export, and analyze responses
* Calculate aggregates, statistics, and crosstabs
* Export charts in various formats (PowerPoint, PDF, Word, PNG)

You authenticate either with an API key (for server-to-server applications) or via OAuth 2.1 (for applications acting on behalf of users).

Base URL: https://platform.empirio.ai/rest/v1

You can find the complete endpoint documentation in the developer documentation.

Question 5

Where do I create an API key?

Accepted Answer

In the empirio.ai dashboard under "Integrations." With a single click, you can generate a new key. Important: The key is only shown once—save it somewhere secure right away (for example, in a password manager or secret store).
API keys have scopes—surveys for survey operations, responses for accessing answers. When creating a key, you can define which permissions it should have.

Question 6

What are webhooks and how do I use them?

Accepted Answer

Webhooks are the counterpart to an API: instead of you regularly polling for data, empirio.ai actively sends the data to you as soon as something happens.
Specifically: as soon as a person completes a survey, empirio.ai sends a signed JSON payload to your configured URL. You can react immediately—for example, send automatic follow-up emails, write data into your CRM, or feed real-time dashboards.

You can register up to three webhook endpoints per survey.
Webhooks are set up under "Integrations".

Question 7

What happens if my webhook endpoint is temporarily unavailable?

Accepted Answer

If an error occurs (timeout, server error, invalid response), empirio.ai will attempt delivery up to three times with increasing intervals: immediately, then after 1 minute, then after 10 minutes.
Important: Webhooks are delivered with at-least-once guarantees. If in doubt, a message will be delivered twice rather than not at all. Use the X-Empirio-Delivery-Id header to detect and ignore duplicates on your side.

Question 8

What is the MCP server?

Accepted Answer

MCP stands for Model Context Protocol – a standard that lets AI agents access external systems directly. With our MCP server, you can connect ChatGPT, Claude, or other compatible AI hosts to your empirio.ai data.

Concrete examples of what your AI agent can do:
“Show me the responses from my latest customer satisfaction survey.”
“Create a 5-question NPS survey for our new product and publish it.”
“Export the responses from survey X as a PowerPoint deck.”
“Delete the last 10 incomplete responses.”

The agent then automatically calls the right tools and delivers the result to you.

Server URL: https://platform.empirio.ai/mcp. Authentication uses OAuth 2.1 with PKCE and is negotiated automatically – you don’t have to configure anything manually.

Question 9

How do I connect Claude or ChatGPT with empirio.ai?

Accepted Answer

For Claude: Go to “Connectors” in the settings, add empirio.ai as a remote MCP server with the URL https://platform.empirio.ai/mcp. Authentication is handled automatically.

For ChatGPT (via the Responses API): Use the MCP server entry in your tool configuration with the same URL.

Once the connection is established, the AI agent has access to all features for which you grant it the necessary permissions (scopes: surveys and/or responses).

Question 10

What is the CLI and when does it make sense to use it?

Accepted Answer

The command-line tool @empirio-ai/cli is an npm-installable interface for developers who prefer working in the terminal or want to integrate empirio.ai into scripts and CI pipelines.

Installation:
npm install -g @empirio-ai/cli

The CLI covers all REST API operations. Authentication works either via empirio login (OAuth, for interactive use) or via the environment variable EMPIRIO_API_KEY (for CI and automation scenarios).

Requirement: Node.js version 20 or newer.

Question 11

What rate limits apply to the integrations?

Accepted Answer

To keep our platform stable for everyone, we have clear limits:

* Read operations: 60 requests per minute per key or user.
* Write operations: 20 requests per minute per key or user.
* Creating surveys: additionally, a maximum of 10 per hour and 50 per day per account.

If you exceed a limit, the API responds with a 429 status and a Retry-After header that tells you how long you need to wait.

For enterprise customers with particularly high demands, we can agree on custom limits.

Question 12

Will my data be transmitted securely when using the integrations?

Accepted Answer

Yes. The integrations follow the same security standards as the rest of the platform:

HTTPS only: Unencrypted connections are rejected.

Bearer token authentication: API keys or OAuth tokens with clearly defined scopes.

Signed webhooks: Every webhook delivery is HMAC-signed and can be verified for authenticity.

Rate limits and idempotency keys: Protect against accidental duplicate executions and abusive usage.

EU hosting: The integration endpoints also run on our EU-based infrastructure.

Question 13

Where can I find the complete technical documentation?

Accepted Answer

You can find the complete developer documentation – including all endpoints, examples, webhook payloads, and error codes – at empirio.ai/docs.
There you can also see which question types are supported by the API, how responses are structured, and how to call filters, aggregates, and exports.

Question 14

Who can I contact if I have technical questions about the integration?

Accepted Answer

Write to us at info@empirio.ai. If you have any questions about the API or integrations, we’re happy to help—ideally include:

What you’re trying to achieve
Which endpoints you’re using
The exact error code and error message (if available)

That way we can quickly understand and reproduce the issue.

Help Center