Skip to content
BENIBIX Learn

Field Mapping

Development🔗 Integration & AutomationIntegration Basics

Also known as Data Mapping, Field Map, Map Fields

Matching the fields of one app to the fields of another.

Think of it like

Think of it like matching socks. Each sock from one pile finds its partner in the other pile.

Example

Lucy maps the shop's email field to the list's address field. She also splits full name into a first and a last name.

Why it matters

A wrong map puts data in the wrong place. Phone numbers end up in the name field, and nobody notices for weeks.

Definition

Field mapping says which field in one app fills which field in another. Two apps rarely use the same names. One app may say email, and the other may say email_address. A map lines them up, one pair at a time. It can also split or join values, like one full name into a first and a last name.

Example code

json
{
  "email": "email_address",
  "full_name": ["first_name", "last_name"],
  "country": "country_code"
}
Each field on the left fills the field of the same row on the right.
The table in the middle is the field map. Email goes to the address field.

Common mistake

Mapping only the fields you see in one test. Empty or odd values in real data then break the run.

Key takeaways

  1. 1
    One pair at a time. Each source field has one home.
  2. 2
    Change the shape. Split, join or reformat while you map.
  3. 3
    Test real data. Try empty and strange values too.