---
title: "The saved mapping for a header row, or a proposal (by a model when configured and your data policy allows — header names only, never values), saved for next time"
method: POST
path: "/api/v1/mappings/{formId}/propose"
tags: ["Automation"]
---

# The saved mapping for a header row, or a proposal (by a model when configured and your data policy allows — header names only, never values), saved for next time

`POST /api/v1/mappings/{formId}/propose`

## Request

- Base URL: `https://philforms.com`
- URL: `https://philforms.com/api/v1/mappings/{formId}/propose`
- Auth: HTTP bearer

## Path parameters

- `formId` string, required

## Request body

- object
  - `header` string[], required

## Response `200`

{ mapping, source: saved|identity|model|name|none, is_model_called, mapped_column, unmapped_column, unfed_parameter }

## Other responses

- `404`: Unknown form

---

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