> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firsttouch.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Public API Overview

> Use the FirstTouch MCP tool catalog through a conventional JSON API.

The FirstTouch Public API exposes the same supported operations as FirstTouch MCP through conventional HTTP requests. Use it for server-to-server integrations that need to work with audiences, flows, contacts, enrichment, tasks, queues, metrics, and other FirstTouch workflows without running an MCP client.

The staging API currently contains **65 operations** generated from the full FirstTouch MCP tool catalog. Tool names, descriptions, input schemas, validation rules, permissions, and business behavior stay aligned with MCP.

<CardGroup cols={2}>
  <Card color="#3c5d29" icon="key" title="Authentication" href="/api-reference/authentication">
    Create a user-scoped API key for the selected team and send it through the `X-API-Key` header.
  </Card>

  <Card color="#3c5d29" icon="rocket" title="Quickstart" href="/api-reference/quickstart">
    Call `get_current_user`, inspect the JSON response, and discover more operations.
  </Card>

  <Card color="#3c5d29" icon="book-open" title="API Operations" href="/api-reference/operations">
    Open the complete human-readable operation catalog in ReDoc.
  </Card>
</CardGroup>

## Staging Endpoints

| Purpose                      | URL                                                              |
| ---------------------------- | ---------------------------------------------------------------- |
| API operations               | `https://stg-gateway.firsttouch.ai/api/public/tools/<tool_name>` |
| Human-readable API reference | `https://stg-gateway.firsttouch.ai/api/public/docs`              |
| OpenAPI document             | `https://stg-gateway.firsttouch.ai/api/public/openapi.json`      |

Every tool operation uses `POST`. Replace `<tool_name>` with the MCP tool name shown in the [API Operations reference](/api-reference/operations).

Example:

```text theme={null}
POST https://stg-gateway.firsttouch.ai/api/public/tools/get_current_user
```

## How It Relates To MCP

The Public API and MCP are two transports over the same FirstTouch operations:

* The Public API accepts a JSON request body and returns normal JSON.
* MCP uses the Model Context Protocol and can use browser OAuth or a compatible API key.
* Both enforce the current user, team, permissions, feature access, credit rules, and workflow validation.
* Rotating or revoking an API key immediately affects both Public API and MCP requests using that key.

<Note>
  The Public API does not bypass FirstTouch permissions or product entitlements. An API key can only perform operations its creator is currently allowed to perform in the key's team.
</Note>

## Request And Response Format

Send a JSON object matching the selected operation's input schema. Operations without arguments accept an empty object:

```json theme={null}
{}
```

Successful calls return the operation result directly as JSON rather than an MCP JSON-RPC or content envelope.

## Next Steps

* [Create and secure an API key](/api-reference/authentication)
* [Make your first request](/api-reference/quickstart)
* [Manage keys in FirstTouch](/WebApp/Settings/api-keys)
* [Browse all API operations in ReDoc](/api-reference/operations)