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

# Field Mapping

> How to map custom fields from third-party integrations onto Merge Common Model fields. Covers creating target fields, configuring mappings per integration, and accessing mapped data via the API.

---

Field Mappings are mappings between third-party Remote Fields and user defined Merge fields. This includes integration-wide and Linked Account specific Field Mappings. Integration-wide Field Mappings apply to all Linked Accounts in your organization for a particular integration. Linked Account level Field Mappings are specific to an end user. [Learn more](/merge-unified/supplemental-data/field-mapping/overview).

> **Info**
>
> Programmatically configuring Field Mappings is only available on our Enterprise plans. View the [Merge Plans](https://www.merge.dev/pricing) to learn more.

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


## API Docs

- Field Mapping [/field-mappings](https://docs.merge.dev/merge-unified/filestorage/linked-account/field-mapping/field-mappings-retrieve.md)
- Field Mapping [/field-mappings/{field_mapping_id}](https://docs.merge.dev/merge-unified/filestorage/linked-account/field-mapping/field-mappings-destroy.md)
- Field Mapping [/remote-fields](https://docs.merge.dev/merge-unified/filestorage/linked-account/field-mapping/remote-fields-retrieve.md)
- Field Mapping [/target-fields](https://docs.merge.dev/merge-unified/filestorage/linked-account/field-mapping/target-fields-retrieve.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.merge.dev/merge-unified/filestorage/linked-account/field-mapping/openapi.json)
- [OpenAPI YAML](https://docs.merge.dev/merge-unified/filestorage/linked-account/field-mapping/openapi.yaml)