---
title: "Run a field mapping"
method: POST
path: "/field-mappings/{selector}/run"
tags: ["FieldMappings"]
---

# Run a field mapping

`POST /field-mappings/{selector}/run`

## Request

- Base URL: `https://api.getmembrane.com`
- URL: `https://api.getmembrane.com/field-mappings/{selector}/run`
- Auth: HTTP bearer

## Path parameters

- `selector` string, required

## Query parameters

- `layer` 'universal' | 'integration' | 'connection'
- `integrationKey` string
- `integrationId` string
- `connectionId` string
- `connectionKey` string
- `instanceKey` string

## Request body

- RunFieldMappingRequestDto
  - `direction` 'import' | 'export' | 'both'
  - `input` object
  - `connectionId` string

## Response `200`

- RunFieldMappingResponseDto
  - `output` object

## Changes

- **2026-11-03** `ca0bbeead07f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getmembrane/apis/membrane-api/changes/field-mappings/:selector/run/post.md)

---

[API](https://skmtc.dev/getmembrane/apis/membrane-api.md) - [All operations](https://skmtc.dev/getmembrane/apis/membrane-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getmembrane/apis/membrane-api/revisions/ca0bbeead07f?raw)