← Back to docs

Field Mapping

Field mapping ensures incoming data matches the structure expected by downstream systems. SyncToScale validates mappings before workflows run.

POST Validate payloads against schemas

Why mapping matters

Incorrect field formats or missing attributes can cause workflow steps to fail. Mapping validation helps catch issues early.

Validating a payload

POST /mapping/validate
{
  "payload": {
    "first_name": "Jordan",
    "start_date": "12/01/2025"
  },
  "expected_schema": {
    "first_name": "string",
    "start_date": "date"
  }
}

Validation response

{
  "valid": false,
  "issues": [
    {
      "field": "start_date",
      "expected": "YYYY-MM-DD"
    }
  ]
}