# About OAuth Apps

Apps on TextMaster allow you to automate and improve your workflow. You can build integrations with the TextMaster API to let your clients order translation, copywriting or proofreading projects of their content.

## Overview

OAuth2 is a protocol that lets external applications request authorization to private details in a user's TextMaster account without accessing their password. This is preferred over Signature Authentication because tokens can be limited to specific types of data and can be revoked by users at any time.

An OAuth App uses TextMaster as an identity provider to authenticate as the user who grants access to the app. When users grant an OAuth App access, they grant permissions to *all* projects they have access to in their account.

Building an OAuth App is a good option if you are creating more complex processes than a simple script can handle. Note that OAuth Apps are applications that need to be hosted somewhere.

Keep these ideas in mind when creating OAuth Apps:

* An OAuth App should always act as the authenticated user across all of TextMaster
* An OAuth App can be used as an identity provider by enabling a "Login with TextMaster" for the authenticated user.
* An OAuth App should only request the permissions it requires to operate normally.

{% hint style="info" %}
**Tips:** OAuth Apps should request only the permissions it is required to operate normally.
{% endhint %}

For more on OAuth Apps, see:

{% content-ref url="building-oauth-apps" %}
[building-oauth-apps](https://developer.textmaster.com/apps/building-oauth-apps)
{% endcontent-ref %}

{% content-ref url="managing-oauth-apps" %}
[managing-oauth-apps](https://developer.textmaster.com/apps/managing-oauth-apps)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.textmaster.com/apps/about-oauth-apps.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.