# Reference

> The REST API, the MCP tools and the webhook events, generated from the contracts: 65 operations and 34 tools.

Source: https://emailmovers.com/mydatahub/docs/reference

The reference is generated from the files the contracts package publishes, so it cannot drift from the API. The tests fail if a page here no longer matches them.

> **Not yet live.** MyDataHub v2 is built and tested locally and is not yet live. The v2 hosts open at launch, date to confirm.

## Pages

- [REST reference](https://emailmovers.com/mydatahub/docs/reference/rest.md): 65 operations at `https://mydatahub.emailmovers.com/v1`, one page each.

- [MCP tool reference](https://emailmovers.com/mydatahub/docs/reference/mcp.md): the 34 tools of `https://mydatahub.emailmovers.com/mcp`, one page each.

- [Webhook events](https://emailmovers.com/mydatahub/docs/reference/webhooks.md): the event types and their payloads.

- [Errors](https://emailmovers.com/mydatahub/docs/errors.md): every problem type, one page each.

## Schema files

The same documents the pages are generated from, as files for code generators and agents.

| File | Path |
| --- | --- |
| [OpenAPI 3.1 document (JSON)](https://emailmovers.com/mydatahub/docs/reference/openapi.json) | `/reference/openapi.json` |
| [OpenAPI 3.1 document (YAML)](https://emailmovers.com/mydatahub/docs/reference/openapi.yaml) | `/reference/openapi.yaml` |
| [Audience JSON Schema (mydatahub.audience/1)](https://emailmovers.com/mydatahub/docs/reference/audience.schema.json) | `/reference/audience.schema.json` |
| [MCP tools/list result](https://emailmovers.com/mydatahub/docs/reference/mcp-tools.json) | `/reference/mcp-tools.json` |

The live OpenAPI document is also served at `GET /v1/openapi.json`.