Sensay API
2025-03-25

Base URL 
https://api.sensay.io

Introduction

Leverage Sensay’s technology to build your own custom products, creating hyper-personalised chatbots.

The Sensay API provides a unified way to build, manage, and integrate AI-driven chatbots (replicas) and conversations into your applications and workflows. It’s designed to support a variety of use cases, from embedding chat into web and mobile apps, to syncing activity across platforms like Discord, Telegram, and custom integrations. With its consistent structure and predictable responses, the API makes it easy to manage replicas, handle chat histories, generate completions, analyze usage, and maintain user data—all while maintaining security and scalability.

How to use this guide

This guide is structured to help you find what you need quickly:

  • Getting started – Learn the basics of authenticating and making your first request.
  • Generating the SDK – Automate API integration by generating and using a client SDK.
  • Authentication – Understand how to manage tokens and secure your calls.
  • Endpoints – Each major feature, such as Replicas, Conversations, Analytics, Users, and Knowledge base, has its own section with usage examples, request/response formats, and best practices.

For more information about Sensay, visit our homepage: https://www.sensay.io.

For requesting an API key, visit Sensay API account request form.

You can play around with the API via Swagger UI at https://api.sensay.io/ui.

Don't forget to join the Sensay API announcements Telegram channel to be notified in advance of breaking changes and new major features!

This API is OpenAPI 3.0.3-compliant and as such you can make use of the extensive tools developed for OpenAPI: find them at https://tools.openapis.org.

This is version 2025-03-25 of this API documentation. Last update on Oct 17, 2025.