# Text Documentation ## Docs ### Getting started - [Quickstart](https://www.text.com/docs/getting-started/index.md): Get up and running with the Text API — make your first call, understand how auth works, and find the right API for what you're building. - [API pricing](https://www.text.com/docs/getting-started/api-pricing.md): Learn how API usage is billed and how to track your request volume. - [Model Context Protocol (MCP)](https://www.text.com/docs/getting-started/mcp.md): Learn how to connect AI assistants to Text using the Model Context Protocol. ### Key concepts - [Chats](https://www.text.com/docs/key-concepts/chats.md): Text conversations are structured as chats, threads, and events. Understanding this model is the foundation for any Text API integration. - [Users and accounts](https://www.text.com/docs/key-concepts/users-and-accounts.md): Who participates in Text conversations, how they're grouped for routing, and how identity works across accounts and organizations. - [API versioning](https://www.text.com/docs/key-concepts/api-versioning.md): How Text API versions work, what each stage means, and what to do at each one. ### API overview - [Messaging](https://www.text.com/docs/api-overview/messaging-apis.md): APIs for the two sides of a Text conversation — agent and customer. - [Management](https://www.text.com/docs/api-overview/management-apis.md): APIs for configuring and managing Text — agents, routing, customer data, and identity. - [Data and analytics](https://www.text.com/docs/api-overview/data-analytics-apis.md): APIs for reporting, event streams, language detection, and custom properties. - [Chat widget](https://www.text.com/docs/api-overview/chat-widget-apis.md): APIs and tools for controlling, extending, and building on the chat widget. ### Authentication - [Overview](https://www.text.com/docs/authentication/overview.md): Understand how authentication and authorization work across Text APIs, what token types exist, and how scopes control what each one can do. - [Scopes](https://www.text.com/docs/authentication/scopes.md): Learn how to use OAuth 2.1 to access Text data securely. Check general rules of scopes. - [Authentication errors](https://www.text.com/docs/authentication/errors.md): OAuth error codes returned by the Text authorization server, their meanings, and possible causes. #### Agent authentication - [Personal access tokens](https://www.text.com/docs/authentication/personal-access-tokens.md): Use personal access tokens to authenticate requests to Text APIs. Learn how to create tokens, configure scopes, and send authorized API requests. ##### OAuth authorization - [OAuth authorization](https://www.text.com/docs/authentication/oauth-authorization/index.md): Learn how OAuth clients work in Text, and choose the right authorization flow for your app. - [Authorization code grant](https://www.text.com/docs/authentication/oauth-authorization/authorization-code-grant.md): Implement the OAuth authorization code grant, with PKCE, to get access and refresh tokens for Text APIs. - [Sign in with Text](https://www.text.com/docs/authentication/oauth-authorization/sign-in-with-text.md): Add a ready-to-use Text login flow to your web app using the Accounts SDK. - [Implicit grant](https://www.text.com/docs/authentication/oauth-authorization/implicit-grant.md): Use the OAuth implicit grant to get an access token directly in the redirect URL. #### Customer authentication - [Customer tokens](https://www.text.com/docs/authentication/customer-tokens.md): Learn the importance of using a different access token for the Customer Chat API. Explore the various customer authorization flows. - [Custom Identity Provider](https://www.text.com/docs/authentication/custom-identity-provider.md): Learn how to use custom identity to build cross-platform chats for your applications. ## Guides ### Data management - [Automate reports exports with a Google Sheets template](https://www.text.com/docs/guides/reports-api-template.md): A Google Sheets template that automates Reports API exports via built-in Apps Script. - [Build an extensible reports dashboard in Metabase](https://www.text.com/docs/guides/metabase-dashboard.md): Build a Metabase dashboard for Text reports you can fully customize and extend — every chart is editable SQL, backed by your own Postgres database. ### Integrations - [Sync any custom Text customer property to HubSpot](https://www.text.com/docs/guides/sync-hubspot-crm.md): Run a Go webhook service that syncs customer properties and chat summaries to HubSpot contacts to power segmentation and automated HubSpot workflows. - [Create tickets with order context from events across multiple Shopify stores](https://www.text.com/docs/guides/shopify-orders-to-tickets.md): Run a webhook service that verifies incoming Shopify events from multiple stores, fetches the order and customer data from Shopify's Admin API, and creates a ticket with order context. - [API reference (764 pages)](https://www.text.com/docs/_llms/api-reference.md): Documentation for API reference. ## Changelog - [Changelog](https://www.text.com/docs/api/changelog.md): Version history for all Text APIs. ## OpenAPI Specs - [openapi](/docs/api/agent-chat/v3.7/openapi.json) - [openapi](/docs/api/agent-chat/v3.6/openapi.json) - [openapi](/docs/api/agent-chat/v3.5/openapi.json) - [openapi](/docs/api/customer-chat/v3.7/openapi.json) - [openapi](/docs/api/customer-chat/v3.6/openapi.json) - [openapi](/docs/api/customer-chat/v3.5/openapi.json) - [openapi](/docs/api/ticketing/openapi.json) - [openapi](/docs/api/configuration/v3.7/openapi.json) - [openapi](/docs/api/configuration/v3.6/openapi.json) - [openapi](/docs/api/configuration/v3.5/openapi.json) - [openapi](/docs/api/customer-data-platform/openapi.json) - [openapi](/docs/api/product-directory/openapi.json) - [openapi](/docs/api/global-accounts/openapi.json) - [openapi](/docs/api/customer-accounts/openapi.json) - [openapi](/docs/api/reports/v3.7/openapi.json) - [openapi](/docs/api/reports/v3.6/openapi.json) - [openapi](/docs/api/reports/v3.5/openapi.json) - [openapi](/docs/api/language-detection/openapi.json) - [openapi](/docs/api/partner/account/openapi.json) - [openapi](/docs/api/partner/affiliate/openapi.json) - [openapi](/docs/api/partner/directory/openapi.json) - [openapi](/docs/api/partner/solution/openapi.json) > The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages. ## Indexes - [API reference (764 pages)](https://www.text.com/docs/_llms/api-reference.md): Documentation for API reference. - [API reference / Configuration API (196 pages)](https://www.text.com/docs/_llms/api-reference/configuration-api.md): Documentation for API reference / Configuration API. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.