Is AI recommending you? Ask Contentstack Canoe for free
Is AI recommending your brand? Find out with Contentstack Canoe for free
Contentstack.comAcademyLogin
CS-log-dark.svgCS-log-dark.svg
  • Changelog
  • APIs
  • SDKs

Platform

  • Solution Center
  • Marketplace
  • Changelog
  • Developers & IT
  • Business users
  • Digital leaders
  • Developer Fast Track
  • Plans & Pricing

Solutions

  • Retail
  • Travel and tourism
  • Financial services
  • Technology
  • Manufacturing
  • E-commerce
  • Localization
  • Personalization
  • Portals and knowledge bases

Resources

  • Academy
  • Docs
  • Contentstack for Developers
  • Product updates
  • Contentstack on Contentstack
  • Blog
  • Insights and analyst reports
  • The Forrester Wave™: Digital Experience Platforms, Q4 2025
  • Webinars
  • Podcasts
  • Glossary
  • Content generative library
  • Community
  • Headless CMS
  • Composable AXP
  • Personalization
  • CDP

Customers

  • Case Studies
  • Customer Care
  • Contentstack Experience Awards
  • Customer support

Partners

  • Overview
  • Find a partner
  • Login

Company

  • About us
  • News
  • Customer support portal
  • Contact

Social

  • Facebook
  • LinkedIn
  • Instagram
  • GitHub
  • YouTube
  • Discord
  • X
LegalTermsPrivacyTrust Center

Cookie settings

Copyright © 2026 Contentstack Inc. All rights reserved.
/
  1. Home
  2. APIs
  3. Lytics API
  4. Jobs
  5. Facebook Conversion Api

Facebook Conversion Api

markdownView as Markdown

Create and manage data import and export jobs.

FacebookConversionApi: Create job

POSThttps://api.lytics.io/v2/job/facebook-conversion-api

Create a FacebookConversionApi job

Sample Request
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657
{
  "auth_ids": [
    "string"
  ],
  "config": {
    "action_source": "string",
    "additional_custom_data": [
      "string"
    ],
    "ads_account_id": "string",
    "attribution_mapping": [
      {
        "property1": "string",
        "property2": "string"
      }
    ],
    "audience_events": "enters_only",
    "currency_code": "string",
    "custom_data_mapping": [
      {
        "property1": "string",
        "property2": "string"
      }
    ],
    "event_id": "string",
    "event_name": "string",
    "event_source_url": "string",
    "event_time": "string",
    "field_changes": [
      "string"
    ],
    "limited_data_use": true,
    "original_event_name": "string",
    "original_event_time": "string",
    "original_order_id": "string",
    "pixel": "string",
    "segment_ids": [
      "string"
    ],
    "send_lytics_audience": true,
    "user_data_mapping": [
      {
        "property1": "string",
        "property2": "string"
      }
    ],
    "withbackfill": true
  },
  "description": "string",
  "drop_events_during_quiet_window": true,
  "expires_at": "2019-08-24T14:15:22Z",
  "monitoring": {},
  "name": "string",
  "quiet_period": 0,
  "quiet_time_of_day": "string",
  "quiet_timezone": "string"
}
Sample Response
Status|201 Created
12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394
{
  "_meta": {},
  "data": {
    "account_id": "string",
    "anomaly_rule": {
      "aid": 0,
      "checks": [
        {
          "allowable_violations": 0,
          "interval": "string",
          "lookback_count": 0,
          "max_threshold": 0,
          "metric_type": "string",
          "min_threshold": 0,
          "type": "string",
          "variance_pct": 0
        }
      ],
      "created": "string",
      "id": "string",
      "subject_id": "string",
      "subject_type": "string",
      "updated": "string"
    },
    "api_token_auth_id": "string",
    "auth_ids": [
      "string"
    ],
    "config": {
      "action_source": "string",
      "additional_custom_data": [
        "string"
      ],
      "ads_account_id": "string",
      "attribution_mapping": [
        {
          "property1": "string",
          "property2": "string"
        }
      ],
      "audience_events": "enters_only",
      "currency_code": "string",
      "custom_data_mapping": [
        {
          "property1": "string",
          "property2": "string"
        }
      ],
      "event_id": "string",
      "event_name": "string",
      "event_source_url": "string",
      "event_time": "string",
      "field_changes": [
        "string"
      ],
      "limited_data_use": true,
      "original_event_name": "string",
      "original_event_time": "string",
      "original_order_id": "string",
      "pixel": "string",
      "segment_ids": [
        "string"
      ],
      "send_lytics_audience": true,
      "user_data_mapping": [
        {
          "property1": "string",
          "property2": "string"
        }
      ],
      "withbackfill": true
    },
    "created": "string",
    "deleted": true,
    "description": "string",
    "drop_events_during_quiet_window": true,
    "expires_at": "2019-08-24T14:15:22Z",
    "id": "string",
    "meta": {},
    "monitoring": {},
    "name": "string",
    "quiet_period": 0,
    "quiet_time_of_day": "string",
    "quiet_timezone": "string",
    "sleep_until": "string",
    "status": "runnable",
    "updated": "string",
    "user_id": "string",
    "workflow": "string",
    "workflow_id": "string"
  },
  "request_id": "string",
  "status": 0
}

FacebookConversionApi: Get job

GEThttps://api.lytics.io/v2/job/facebook-conversion-api/{id}

Get the summary of a FacebookConversionApi job

Sample Response
Status|200 OK
12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394
{
  "_meta": {},
  "data": {
    "account_id": "string",
    "anomaly_rule": {
      "aid": 0,
      "checks": [
        {
          "allowable_violations": 0,
          "interval": "string",
          "lookback_count": 0,
          "max_threshold": 0,
          "metric_type": "string",
          "min_threshold": 0,
          "type": "string",
          "variance_pct": 0
        }
      ],
      "created": "string",
      "id": "string",
      "subject_id": "string",
      "subject_type": "string",
      "updated": "string"
    },
    "api_token_auth_id": "string",
    "auth_ids": [
      "string"
    ],
    "config": {
      "action_source": "string",
      "additional_custom_data": [
        "string"
      ],
      "ads_account_id": "string",
      "attribution_mapping": [
        {
          "property1": "string",
          "property2": "string"
        }
      ],
      "audience_events": "enters_only",
      "currency_code": "string",
      "custom_data_mapping": [
        {
          "property1": "string",
          "property2": "string"
        }
      ],
      "event_id": "string",
      "event_name": "string",
      "event_source_url": "string",
      "event_time": "string",
      "field_changes": [
        "string"
      ],
      "limited_data_use": true,
      "original_event_name": "string",
      "original_event_time": "string",
      "original_order_id": "string",
      "pixel": "string",
      "segment_ids": [
        "string"
      ],
      "send_lytics_audience": true,
      "user_data_mapping": [
        {
          "property1": "string",
          "property2": "string"
        }
      ],
      "withbackfill": true
    },
    "created": "string",
    "deleted": true,
    "description": "string",
    "drop_events_during_quiet_window": true,
    "expires_at": "2019-08-24T14:15:22Z",
    "id": "string",
    "meta": {},
    "monitoring": {},
    "name": "string",
    "quiet_period": 0,
    "quiet_time_of_day": "string",
    "quiet_timezone": "string",
    "sleep_until": "string",
    "status": "runnable",
    "updated": "string",
    "user_id": "string",
    "workflow": "string",
    "workflow_id": "string"
  },
  "request_id": "string",
  "status": 0
}

FacebookConversionApi: Update job

PUThttps://api.lytics.io/v2/job/facebook-conversion-api/{id}

Update a FacebookConversionApi job

Sample Request
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657
{
  "auth_ids": [
    "string"
  ],
  "config": {
    "action_source": "string",
    "additional_custom_data": [
      "string"
    ],
    "ads_account_id": "string",
    "attribution_mapping": [
      {
        "property1": "string",
        "property2": "string"
      }
    ],
    "audience_events": "enters_only",
    "currency_code": "string",
    "custom_data_mapping": [
      {
        "property1": "string",
        "property2": "string"
      }
    ],
    "event_id": "string",
    "event_name": "string",
    "event_source_url": "string",
    "event_time": "string",
    "field_changes": [
      "string"
    ],
    "limited_data_use": true,
    "original_event_name": "string",
    "original_event_time": "string",
    "original_order_id": "string",
    "pixel": "string",
    "segment_ids": [
      "string"
    ],
    "send_lytics_audience": true,
    "user_data_mapping": [
      {
        "property1": "string",
        "property2": "string"
      }
    ],
    "withbackfill": true
  },
  "description": "string",
  "drop_events_during_quiet_window": true,
  "expires_at": "2019-08-24T14:15:22Z",
  "monitoring": {},
  "name": "string",
  "quiet_period": 0,
  "quiet_time_of_day": "string",
  "quiet_timezone": "string"
}
Sample Response
Status|200 OK
12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394
{
  "_meta": {},
  "data": {
    "account_id": "string",
    "anomaly_rule": {
      "aid": 0,
      "checks": [
        {
          "allowable_violations": 0,
          "interval": "string",
          "lookback_count": 0,
          "max_threshold": 0,
          "metric_type": "string",
          "min_threshold": 0,
          "type": "string",
          "variance_pct": 0
        }
      ],
      "created": "string",
      "id": "string",
      "subject_id": "string",
      "subject_type": "string",
      "updated": "string"
    },
    "api_token_auth_id": "string",
    "auth_ids": [
      "string"
    ],
    "config": {
      "action_source": "string",
      "additional_custom_data": [
        "string"
      ],
      "ads_account_id": "string",
      "attribution_mapping": [
        {
          "property1": "string",
          "property2": "string"
        }
      ],
      "audience_events": "enters_only",
      "currency_code": "string",
      "custom_data_mapping": [
        {
          "property1": "string",
          "property2": "string"
        }
      ],
      "event_id": "string",
      "event_name": "string",
      "event_source_url": "string",
      "event_time": "string",
      "field_changes": [
        "string"
      ],
      "limited_data_use": true,
      "original_event_name": "string",
      "original_event_time": "string",
      "original_order_id": "string",
      "pixel": "string",
      "segment_ids": [
        "string"
      ],
      "send_lytics_audience": true,
      "user_data_mapping": [
        {
          "property1": "string",
          "property2": "string"
        }
      ],
      "withbackfill": true
    },
    "created": "string",
    "deleted": true,
    "description": "string",
    "drop_events_during_quiet_window": true,
    "expires_at": "2019-08-24T14:15:22Z",
    "id": "string",
    "meta": {},
    "monitoring": {},
    "name": "string",
    "quiet_period": 0,
    "quiet_time_of_day": "string",
    "quiet_timezone": "string",
    "sleep_until": "string",
    "status": "runnable",
    "updated": "string",
    "user_id": "string",
    "workflow": "string",
    "workflow_id": "string"
  },
  "request_id": "string",
  "status": 0
}
Hide Parameters

Query Parameters

account_idoptionalstring

The account ID. Defaults to the user's default account.

Headers

Authorizationoptionalstring

Body Parameters

auth_idsoptionalstring[]

Authorization IDs associated with the Job

configrequiredobject

Job configuration, unique per-workflow

config.action_sourceoptionalstring
config.additional_custom_dataoptionalstring[]
config.ads_account_idoptionalstring

Select the Facebook Ads Account to use

config.attribution_mappingoptionalobject[]

Required for AppendAttribution: map user fields to attribution parameters (ad_id, touchpoint_ts, attribution_share, attribution_value). Map the click id (fbc) under User Data Parameters instead

config.audience_eventsoptionalstring

Select which type of audience trigger events to send to Facebook conversion api

One of: enters_only, exits_only

config.currency_codeoptionalstring
config.custom_data_mappingoptionalobject[]
config.event_idoptionalstring
config.event_nameoptionalstring
config.event_source_urloptionalstring
config.event_timeoptionalstring
config.field_changesoptionalstring[]

Select up to 75 user fields to trigger user change events. For any user in the exported audience, if any of the selected field values change, then the user field change event will be sent to the Facebook API.

config.limited_data_useoptionalboolean

Flag every event for Meta Limited Data Use (LDU); Meta applies LDU restrictions based on the user's location (US state privacy laws)

config.original_event_nameoptionalstring

Custom Attribution (AppendAttribution) — the fields below apply only when Event Name is "AppendAttribution",

which credits a conversion Meta already received rather than sending a standard conversion event.

config.original_event_timeoptionalstring

Required for AppendAttribution: user field holding the original conversion's timestamp

config.original_order_idoptionalstring

For AppendAttribution: user field holding the order id that links to the original conversion

config.pixeloptionalstring

Select your [Facebook Pixel](https://developers.facebook.com/docs/facebook-pixel/using-the-pixel) to link the Lytics audience(s) events

config.segment_idsoptionalstring[]

Select Lytics audience(s) to send to Facebook Conversion API

config.send_lytics_audienceoptionalboolean
config.user_data_mappingoptionalobject[]
config.withbackfilloptionalboolean

Select to add users who already exist in the selected Lytics audience

descriptionoptionalstring

A user-defined description

drop_events_during_quiet_windowoptionalboolean
expires_atoptionalstring (date-time)
monitoringoptionalobject

Inline monitoring config. On write: omit to keep, null to clear, or a config to set.

namerequiredstring

A user-defined name

quiet_periodoptionalinteger
quiet_time_of_dayoptionalstring
quiet_timezoneoptionalstring
Hide Parameters

URL Parameters

idrequiredstring

The Job ID

Query Parameters

account_idoptionalstring

The account ID. Defaults to the user's default account.

Headers

Authorizationoptionalstring

Hide Parameters

URL Parameters

idrequiredstring

The Job ID

Query Parameters

account_idoptionalstring

The account ID. Defaults to the user's default account.

Headers

Authorizationoptionalstring

Body Parameters

auth_idsoptionalstring[]

Authorization IDs associated with the Job

configrequiredobject

Job configuration, unique per-workflow

config.action_sourceoptionalstring
config.additional_custom_dataoptionalstring[]
config.ads_account_idoptionalstring

Select the Facebook Ads Account to use

config.attribution_mappingoptionalobject[]

Required for AppendAttribution: map user fields to attribution parameters (ad_id, touchpoint_ts, attribution_share, attribution_value). Map the click id (fbc) under User Data Parameters instead

config.audience_eventsoptionalstring

Select which type of audience trigger events to send to Facebook conversion api

One of: enters_only, exits_only

config.currency_codeoptionalstring
config.custom_data_mappingoptionalobject[]
config.event_idoptionalstring
config.event_nameoptionalstring
config.event_source_urloptionalstring
config.event_timeoptionalstring
config.field_changesoptionalstring[]

Select up to 75 user fields to trigger user change events. For any user in the exported audience, if any of the selected field values change, then the user field change event will be sent to the Facebook API.

config.limited_data_useoptionalboolean

Flag every event for Meta Limited Data Use (LDU); Meta applies LDU restrictions based on the user's location (US state privacy laws)

config.original_event_nameoptionalstring

Custom Attribution (AppendAttribution) — the fields below apply only when Event Name is "AppendAttribution",

which credits a conversion Meta already received rather than sending a standard conversion event.

config.original_event_timeoptionalstring

Required for AppendAttribution: user field holding the original conversion's timestamp

config.original_order_idoptionalstring

For AppendAttribution: user field holding the order id that links to the original conversion

config.pixeloptionalstring

Select your [Facebook Pixel](https://developers.facebook.com/docs/facebook-pixel/using-the-pixel) to link the Lytics audience(s) events

config.segment_idsoptionalstring[]

Select Lytics audience(s) to send to Facebook Conversion API

config.send_lytics_audienceoptionalboolean
config.user_data_mappingoptionalobject[]
config.withbackfilloptionalboolean

Select to add users who already exist in the selected Lytics audience

descriptionoptionalstring

A user-defined description

drop_events_during_quiet_windowoptionalboolean
expires_atoptionalstring (date-time)
monitoringoptionalobject

Inline monitoring config. On write: omit to keep, null to clear, or a config to set.

namerequiredstring

A user-defined name

quiet_periodoptionalinteger
quiet_time_of_dayoptionalstring
quiet_timezoneoptionalstring