Field Mapping¶

Field mapping allows you to use custom property names in Notion or Airtable while still connecting to Pablo. Instead of renaming all your properties to match Pablo's expected field names, you provide a mapping configuration that tells Pablo which of your properties correspond to which Pablo fields.

How It Works¶

When setting up your webhook URL, you add a field_map parameter containing a URL-encoded JSON object that maps your custom property names to Pablo's internal field names.

Format:

https://app.pablo.social/webhooks/notion?api_key=YOUR_KEY&field_map=URL_ENCODED_JSON

The field_map JSON structure:

{
  "Your Property Name": "pablo_field_name",
  "Another Custom Name": "another_pablo_field"
}

Example¶

If your Notion database uses these property names: - "Ad Name" instead of ad_name - "Title" instead of ad_headline - "Description" instead of ad_body - "URL" instead of ad_link_url

Create this mapping:

{
  "Ad Name": "ad_name",
  "Title": "ad_headline",
  "Description": "ad_body",
  "URL": "ad_link_url"
}

URL-encode it:

You must URL-encode the JSON before adding it to the webhook URL. Use any URL encoder tool or programming language. Use any URL encoder like urlencoder.org.

%7B%22Ad%20Name%22%3A%22ad_name%22%2C%22Title%22%3A%22ad_headline%22%2C%22Description%22%3A%22ad_body%22%2C%22URL%22%3A%22ad_link_url%22%7D

Final webhook URL:

https://app.pablo.social/webhooks/notion?api_key=YOUR_KEY&field_map=%7B%22Campaign%20Name%22%3A%22ad_name%22%2C%22Title%22%3A%22ad_headline%22%2C%22Description%22%3A%22ad_body%22%2C%22URL%22%3A%22ad_link_url%22%7D