Connect Facebook to Mantle and automate your tasks

Why integrate Facebook with Mantle

The Facebook to Mantle integration helps you sync data, automate manual tasks, and keep your stack aligned — without writing code.

Sync Shopify audiences to Facebook Ads in real time

When a customer's tags, purchase history, or lifecycle stage changes in Shopify, MESA updates the corresponding Facebook Ads audience. Your campaigns always target the right people without manual list exports.

Launch retargeting audiences from Shopify order events

When a customer abandons checkout, completes a first purchase, or hits a spend threshold, MESA adds them to the right Facebook Ads audience automatically. Your retargeting runs on live customer behavior, not a weekly CSV upload.

Pause or adjust campaigns when inventory runs low

When stock drops below a threshold in Shopify, MESA triggers a Facebook Ads update — pausing a campaign, adjusting a budget, or flagging it for review. You stop spending on products you can't fulfill without checking ad accounts manually.

Sync Shopify customer data with Mantle subscription records

When a customer's order history, tags, or profile changes in Shopify, MESA updates the corresponding Mantle record. Your subscription analytics and billing data reflect the full picture of each customer, not just their subscription activity.

Trigger retention workflows when subscription health drops

When Mantle flags a churn risk, a failed payment, or a usage signal, MESA kicks off the right response — a Klaviyo flow, a Slack alert, a Shopify tag update. You act on subscription health signals before they become cancellations.

Update Shopify customer records when subscription plans change

When a customer upgrades, downgrades, or pauses their plan in Mantle, MESA updates their Shopify tags, fields, and connected tools in real time. Every system reflects the current relationship without manual updates.

Build any Facebook and Mantle automation

MESA helps you connect apps to automate repetitive tasks. A trigger is an event that starts a workflow, and actions are the steps that occur when it's running.

Customer Account Deactivated

Starts when a customer account is deactivated.

• ID
• Email
• Tags
• Test
• Mantle
• Shopify
• Icon URL
• Timezone
• URL
• Domain
• Name
• City
• Province
• Country Code
• Currency Code
• Industry
• App Installation
• Billing Status

Customer Account Reactivated

Starts when a customer account is reactivated.

Customer Activated One Time Charge

Starts when a customer activates a one-time charge.

Customer Approaching Capped Limit

Starts when a customer is approaching a usage metric limit.

Customer Downgraded

Starts when a customer downgrades their plan.

Customer Exceeded Capped Amount

Starts when a customer exceeds the usage metric amount limit.

Customer Exceeded Usage Charge Limit

Starts when a customer exceeds the usage charge limit.

Customer First Identify

Starts when a customer is first identified by your app.

Customer Installed

Starts when a customer installs your app.

Customer Refunded

Starts when a customer is refunded a charge.

• Topic
• Event
• App
• Customer
• Subscription
• Transaction

Customer Reinstalled

Starts when a customer reinstalls your app.

Customer Resubscribed

Starts when a customer resubscribes to a plan after being unsubscribed.

Customer Subscribed

Starts when a customer subscribes to one of your app's plans.

Customer Trial Expired

Starts when a customer's trial expires.

Customer Uninstalled

Starts when a customer uninstalls your app.

Customer Unsubscribed

Starts when a customer unsubscribes from one of your app's plans.

Customer Updated

Starts when a customer is updated.

Customer Upgraded

Starts when a customer upgrades their plan.

Customer Usage Event Created

Starts when a customer usage event is created.

Customer's Subscription Frozen

Starts when a customer's subscription freezes.

Customer's Subscription Unfrozen

Starts when a customer subscription unfreezes.

Review Received

Starts when a customer leaves a review.

• ID
• Type
• Date
• App
• Rating
• Edited
• Content
• Location
• Time Spent Using App
• Merchant Name

Add Customer Tags

Adds tags to a customer.

• ID
• Name
• Email
• Domain
• Shopify Domain
• Tags
• Custom Fields
• App Installations
• Company ID
• Billing Address
• Contacts

Archive Plan

Archive a plan. Archived plans cannot be mutated.

• ID
• Name
• Description
• Amount
• Currency Code
• Type
• Public
• Visible
• Interval
• Trial Days
• Monthly Revenue
• Lifetime Value
• Average Lifetime Value
• Subscriber Count
• Active Trial Count
• Flex Billing
• Flex Billing Terms
• Deprecated At
• Features
• Customer ID
• Customer Tags
• Customer Exclude Tags
• Shopify Plans
• Created At
• Updated At

Create App Feature

Creates a new app feature.

• Name
• Key
• Type
• Default Value
• Description
• Usage Metric ID

Create App Usage Metric

Create an app metric for usage.

• Name
• Event Name
• Calculation
• Params

Create Company

Create a company.

• Name
• Parent Customer ID

Create Contact

Create a contact.

• Name
• Email
• Phone
• Job Title
• Notes
• Tags
• Customers

Create Custom Field

Create a custom field.

• App ID
• Name
• Type
• Default Value
• Options
• App Level
• Show On Customer Detail
• Private

Create Customer

Create a new customer.

• Name
• Email
• Domain
• Shopify Domain
• Tags
• Custom Fields
• App Installations

Create Plan

Create an app plan.

• Name
• Description
• Interval
• Currency Code
• Amount
• Trial Days
• Public
• Visible
• Customer Tags
• Customer Exclude Tags
• Shopify Plans
• Customer
• Plan Usage Charges
• Custom Fields
• Type
• Flex Billing
• Flex Billing Terms
• On Usage Limit Reached
• Auto Upgrade To Plan ID
• Roll Over Pending Usage
• Usage Charge Capped Amount
• Features

Create Usage Event

Create a new usage event.

• Timestamp
• Properties
• Customer ID
• App ID
• Event Name
• Event ID
• Private

Delete App Feature

Remove an app feature within an organization.

Delete App Usage Metric

Remove an app's usage metric.

• Success

Delete Company

Remove a company.

Delete Contact

Remove a contact.

• Success

Delete Custom Field

Remove a custom field.

• Success

Get List of App Events

Obtain a list of all app events for a specific app.

• ID
• Type
• App ID
• Customer ID
• App Installation ID
• Transaction ID
• Previous Subscription ID
• Subscription ID
• Occurred At
• Created At
• Updated At

Get List of App Features

Obtain a list of an app's features.

• ID
• Name
• Key
• Type
• Description
• Default Value
• Usage Metric
• Created At
• Updated At

Get List of App Usage Metrics

Obtain a list of all app's usage metrics.

• ID
• Name
• Event Name
• Calculation
• Params

Get List of App's Plans

Obtain a list of app's plans.

• Total
• Plans
• Has More
• Next Cursor

Get List of Apps

Obtain a list of all apps that the authenticated user has permission to access.

• ID
• Name
• Display Name
• Created At
• Icon URL
• Slug
• Development

Get List of Charges

Obtain a list of all charges for a specific organization.

• ID
• Billed On
• Name
• Customer Name
• Customer Domain
• App Name
• Type
• Status
• Amount
• Currency Code
• Paid On
• Test

Get List of Companies

Obtain a list of companies.

• Has Next Page
• Has Previous Page
• Next Cursor
• Previous Cursor
• Companies

Get List of Contacts

Obtain a list of all contacts.

• Total
• Has Next Page
• Has Previous Page
• Cursor
• Contacts

Get List of Custom Fields

Obtain a list of custom fields.

• ID
• Name
• Type
• Options
• Default Value
• App ID
• App Level
• Show On Customer Detail
• Private

Get List of Customer Segments

Obtain a list of all customer segments for the authenticated organization. Only public segments are returned.

• ID
• Name
• Filters

Get List of Customers

Obtain a list of all customers.

• Total
• Has Next Page
• Has Previous Page
• Cursor
• Customers

Get List of Subscriptions

Obtain a list of subscriptions across all apps and customers.

• ID
• Plan
• Line Items
• Active
• Cancel On
• Billing Cycle Anchor
• Current Period Start
• Current Period End
• Trial Starts At
• Trial Expires At
• Activated At
• Canceled At
• Frozen At
• Features
• Features Order
• Created At
• Confirmation URL
• Shopify Subscription
• Usage Capped Amount
• Usage Balance Used
• Applied Discount
• Subtotal
• Total
• Presentment Subtotal
• Presentment Total

Get List of Transactions

Obtain a list of all transactions.

• ID
• Type
• Date
• Processing Fee
• Processing Fee Currency Code
• Net Amount
• Net Amount Currency Code
• Gross Amount
• Gross Amount Currency Code
• Created At
• Updated At
• Subscription ID
• App ID

Get List of Usage Events

Obtain a list of usage events.

• ID
• Event ID
• Event Name
• Timestamp
• Properties
• App ID
• Customer ID
• Customer

Get List of Users

Obtain a list of all users in an organization.

• ID
• Name
• Email

Remove Customer Tags

Remove tags from a customer.

• ID
• Name
• Email
• Domain
• Shopify Domain
• Tags
• Custom Fields
• App Installations
• Company ID
• Billing Address
• Contacts

Retrieve App

Grab all details about an app.

• ID
• Name
• Display Name
• Created At
• Icon URL
• Slug
• Development

Retrieve App Event

Grab details for a single app event for a specific app.

• ID
• Type
• App ID
• Customer ID
• App Installation ID
• Transaction ID
• Previous Subscription ID
• Subscription ID
• Occurred At
• Created At
• Updated At

Retrieve App Feature

Grab all details about an app feature within an organization.

• ID
• Name
• Key
• Type
• Description
• Default Value
• Usage Metric
• Created At
• Updated At

Retrieve App Usage Metric

Grab all details about an app's usage metric.

• ID
• Name
• Event Name
• Calculation
• Params

Retrieve Company

Grab all details about a company.

• ID
• Name
• Created At
• Parent Customer ID
• Customer Ids
• Updated At

Retrieve Contact

Grab all details about a contact.

• ID
• Name
• Email
• Phone
• Job Title
• Label
• Customers
• Notes
• Tags
• Created At
• Updated At

Retrieve Custom Field

Grab all details about a custom field.

• ID
• Name
• Type
• Options
• Default Value
• App ID
• App Level
• Show On Customer Detail
• Private

Retrieve Customer

Grab all details about a customer.

• ID
• Name
• Email
• Domain
• Shopify Domain
• Tags
• Custom Fields
• App Installations
• Company ID
• Billing Address
• Contacts

Retrieve Customer Segment

Grab all details about a customer segment.

• ID
• Name
• Filters

Retrieve Organization

Grab all details about an organization.

• ID
• Name
• Customer Tags
• Contact Tags
• Current Installation

Retrieve Subscription

Grab all details about a single subscription.

Retrieve Transaction

Grab all details about a transaction with the current organization.

Retrieve User

Grab all details about a user.

• ID
• Name
• Email

Unarchive Plan

Mark a plan as no longer deprecated. It can be mutated after being unarchived.

Update App Feature

Modify an app feature within an organization.

• ID
• Name
• Key
• Type
• Description
• Default Value
• Usage Metric
• Created At
• Updated At

Update App Usage Metric

Modify an existing app's usage metric.

• Name
• Event Name
• Calculation
• Params

Update Company

Modify an existing company.

• Name
• Parent Customer ID

Update Contact

Modify an existing contact.

• Name
• Email
• Phone
• Job Title
• Notes
• Tags
• Customers

Update Custom Field

Modify an existing custom field.

• App ID
• Default Value
• Options
• App Level
• Show On Customer Detail
• Private

Update Customer

Modify an existing customer.

• Name
• Email
• Domain
• Shopify Domain
• Tags
• Custom Fields
• App Installations

Update Plan

Modify an existing plan. Certain properties like amount, interval, and currency code cannot be updated.

• Public
• Visible
• Name
• Description
• Deprecated
• Trial Days
• Features
• Needs Review
• Customer Tags
• Customer Exclude Tags
• Shopify Plans
• Customer
• Plan Usage Charges
• Amount
• Interval
• Custom Fields
• Usage Charge Capped Amount
• Base Plan Ids
• Type
• Flex Billing
• Flex Billing Terms
• On Usage Limit Reached
• Auto Upgrade To Plan ID
• Roll Over Pending Usage
• Recurring Interval
• Recurring Interval Count

Add User to Custom Audience

Add a user to a custom audience based on matching availability.

• Audience ID
• Num Invalid Entries

Create Ad

Create a new ad.

• Name
• Ad Set ID
• Campaign ID
• Creative ID
• Creative
• Status

Create Ad Account Ad

Create a new Ad within an Ad Account.

• Name
• Ad Set ID
• Campaign ID
• Creative ID
• Creative
• Status

Create Ad Account Ad Set

Create a new ad set within an Ad Account.

• Name
• Daily Budget
• Bid Amount
• Billing Event
• Optimization Goal
• Campaign ID
• Promoted Object
• Targeting
• Status
• End Time

Create Ad Account Campaign

Create a new campaign within an Ad Account.

• Name
• Special Ad Categories
• Objective
• Status

Create Ad Set

Create a new Ad Set.

• Name
• Daily Budget
• Bid Amount
• Billing Event
• Optimization Goal
• Campaign ID
• Promoted Object
• Targeting
• Status
• End Time

Create Product

Create a new product.

• Name
• Currency
• Price
• Image URL
• Category
• Retailer ID
• URL
• Description
• Short Description
• Brand

Delete Ad

Remove an existing ad.

• Success

Delete Ad Set

Remove an existing ad set.

• Success

Delete Campaign

Remove an existing campaign.

• Success

Get Ad Account Insights

Generate a custom report to get statistics for campaigns belonging to an ad account.

• Impressions
• Ad ID
• Date Start
• Date Stop

Get Ad Insights

Generate a custom report on the performance of the ad.

• Impressions
• Ad ID
• Date Start
• Date Stop

Get Ad Set insights

Generate a custom report on the performance of the ad set.

• Impressions
• Ad ID
• Date Start
• Date Stop

Get Campaign Insights

Generate a custom report on the performance of the campaign.

• Impressions
• Ad ID
• Date Start
• Date Stop

List Ad Account Campaigns

Obtain a list of campaigns for an ad account.

• ID
• Name
• Special Ad Categories
• Objective
• Status

List Ad Set Ads

Obtain a list of ads belonging to an ad set.

• Name
• Ad Set ID
• Campaign ID
• Creative ID
• Creative
• Status

List Campaign Ad Sets

Obtain a list of ad sets for a campaign.

• Name
• Daily Budget
• Bid Amount
• Billing Event
• Optimization Goal
• Campaign ID
• Promoted Object
• Targeting
• Status
• End Time

List Campaign Ads

Obtain a list of ads for a campaign.

• Name
• Ad Set ID
• Campaign ID
• Creative ID
• Creative
• Status

List Products

Obtain a list of products.

• Name
• Currency
• Price
• Image URL
• Category
• Retailer ID
• URL
• Description
• Short Description
• Brand

Remove User from Custom Audience

Removes a user from a custom audience based on matching availability.

• Audience ID
• Num Invalid Entries

Retrieve Ad

Grab all details about an existing ad.

• Name
• Ad Set ID
• Campaign ID
• Creative ID
• Creative
• Status

Retrieve Ad Set

Grab all details about an existing ad set.

Retrieve Campaign

Grab all details about an existing campaign.

• ID
• Name
• Objective
• Status

Update Campaign

Update an existing campaign.

• Name
• Special Ad Categories
• Objective
• Status