> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/merge-unified/hris/data-management/scopes/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# Scopes

> How to use Common Model Scopes to restrict which models and fields Merge syncs. Configure scopes globally or per Linked Account to limit data access.

---

Scopes allows for precise control over data permissions, ensuring that only relevant Common Models and fields are synced through Merge. Disabling a Common Model Scope will also disable all of its associated fields.

Below, you'll find endpoints related to two levels of Scopes.

* **Default Scopes** apply to new Linked Accounts for a given category
* **Linked Account Scopes** apply only to a specific end user (Linked Account).

The Scopes applied to a Linked Account are first determined by the Linked Account Scopes, and fall back to Default Scopes for any that haven't been set. [Learn More](https://help.merge.dev/en/articles/5950052-common-model-and-field-scopes).

> Build once. Connect to every API, tool, and LLM. Ship products and agents to production without owning the integration stack.


## API Docs

- Scopes [/default-scopes](https://docs.merge.dev/merge-unified/hris/data-management/scopes/default-scopes-retrieve.md)
- Scopes [/linked-account-scopes](https://docs.merge.dev/merge-unified/hris/data-management/scopes/linked-account-scopes-retrieve.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.merge.dev/merge-unified/hris/data-management/scopes/openapi.json)
- [OpenAPI YAML](https://docs.merge.dev/merge-unified/hris/data-management/scopes/openapi.yaml)