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 behaviour may still change. You can find more information at https://www.empirio.ai/integrations, including full developer documentation.

For everyone who doesn’t just want to use empirio.ai via the web interface, but would like 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, sending a Slack message after each response or passing data into reporting. Data analysts who regularly process responses further in SPSS, R or Python and want to automate exports. Teams working with AI agents who want to give their agents direct access to empirio.ai – via the MCP server.

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

The REST API is the classic interface for programmatic survey management. Via HTTPS you can: * create, edit, publish, duplicate and delete surveys * retrieve, filter, export and analyse responses * calculate aggregates, statistics and cross tabulations * 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 full endpoint documentation in the developer documentation.

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

Webhooks are the counterpart to the 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 by sending automatic follow-up emails, writing data into your CRM, or feeding real-time dashboards. You can register up to three webhook endpoints per survey. Webhooks are set up under "Integrationen".

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.

MCP stands for Model Context Protocol – a standard that allows AI agents to 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 then 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 need to configure anything manually.

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 functions for which you grant it the necessary permissions (scopes: surveys and/or responses).

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 is handled 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.

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 individual limits.

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 use. EU hosting: The integration endpoints also run on our EU-based infrastructure.

You can find the complete developer documentation – with 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.

Write to us at info@empirio.ai. If you have any questions about the API or integrations, we’ll be 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.