Skip to main content
Home Ecommerce Knowledge How to Set Up Facebook Conversions API on Shopify: A Step-By-Step Guide 2025

How to Set Up Facebook Conversions API on Shopify: A Step-By-Step Guide 2026

Sam|
August 7, 2025|
9 min read
Summarize this post with AI

What causes the gap between your Facebook Ads spend and conversions on Shopify? In most cases, it’s poor tracking. That’s where the Facebook Conversions API (CAPI), also known as the Shopify Facebook API, comes in. Unlike the Pixel, which relies solely on browser data and can miss key events, CAPI sends server-side data directly to Facebook—giving you a more complete and reliable view of your customers’ journey. 

In this guide, you’ll learn how to set up Facebook Conversions API on Shopify, test it, troubleshoot common issues, and optimize your tracking for better ad performance. Let’s unlock the tracking that Shopify and Facebook were meant to have.

What is Facebook Conversions API?

Facebook Conversions API

Facebook Conversions API (CAPI) is a server-side tool that allows you to send web events—such as purchases, sign-ups, or page views—directly from your server to Facebook. Unlike the traditional Facebook Pixel, which collects data through the user’s browser, CAPI operates server-side, meaning it captures data even when browser tracking is blocked (e.g. due to ad blockers or iOS privacy restrictions). This ensures more accurate tracking, better attribution, and improved ad optimization. 

When used alongside the Pixel, CAPI helps create a more complete picture of the customer journey, leading to smarter targeting and higher return on ad spend (ROAS).

What You’ll Need Before You Start  

Before setting up the Shopify Facebook conversion API, ensure you have the following ready:

  • Facebook Business Manager account: You’ll need a Business Manager to manage your Facebook Pixel, ad account, and connect your Shopify store. This is also where you’ll configure your Facebook Conversions API settings.
  • Facebook Pixel installed on Shopify: The Facebook Pixel must be set up and linked through Shopify’s Facebook & Instagram app. CAPI complements the Pixel; it doesn’t replace it.
  • Shopify admin access: Admin-level access is required to install and configure Facebook integrations, adjust data sharing settings, and verify domain ownership.
  • Access token from Events Manager: This token authorizes your store to send server-side events via CAPI. It’s generated inside Facebook’s Events Manager.
  • Verified domain in Business Manager: Domain verification ensures proper attribution, helps avoid data loss, and is mandatory for event prioritization under Facebook’s Aggregated Event Measurement.
  • Maximum data sharing enabled (recommended): In Shopify’s Facebook Channel settings, choose “Maximum” under customer data sharing. This boosts event match quality by sending additional hashed data.
  • Basic technical familiarity (optional, but helpful): While Shopify handles most of the setup, understanding how CAPI and Pixel work together will help with troubleshooting and optimizing your event flow.

How to Set Up Facebook Conversions API on Shopify

To connect Shopify Facebook CAPI correctly, follow the steps below in order. This setup uses Meta’s official partner integration, no manual coding required:

Step 1: Prepare Your Facebook Setup

  • Go to Meta Business Suite.
  • Click “All Tools” in the left sidebar → Select “Events Manager.”
How to Set Up Facebook Conversions API on Shopify 1
  • Click “”Data Sources,” and you’ll see a list of your existing Pixels. Keep this tab open, you’ll come back here later to complete the connection.
How to Set Up Facebook Conversions API on Shopify 2

Step 2: Install the Facebook & Instagram apps in Shopify

  • In your Shopify admin, click “Settings” (bottom-left corner).
  • Select “Apps and sales channels” from the left menu.
  • Click “Shopify App Store” (top-right).
How to Set Up Facebook Conversions API on Shopify 3
  • Search for “Facebook & Instagram” by Meta.
  • Click “Install,” then confirm again by clicking “Install” at the bottom right. The app may take a few moments to appear.
How to Set Up Facebook Conversions API on Shopify 4

Step 3: Run Initial Setup in Shopify

After installation, return to the Facebook & Instagram app in your Shopify admin and click “Get Started.” Then complete the setup in the following order:

  1. Facebook Account:
    • Click “Connect Account 
    • Log in with your email or phone number and password 
    • You may be prompted for identity verification on your phone (e.g., tap “Yes, it’s me”). Click “Finish,” then choose “Trust This Device” if asked.
    • Finally, approve access for Shopify by clicking “Continue as [Your Name].”
How to Set Up Facebook Conversions API on Shopify 5
  1. Business Portfolio:
    • Select an existing business account → Click “Connect.”
    • Or click “Create new” if you want to create a new account.
How to Set Up Facebook Conversions API on Shopify 6
  1. Data Sharing Settings:
    • Turn on the Share Data button
    • Choose your data sharing level:
      • Conservative – least data shared
      • Enhanced – default option
      • Maximum – shares full event and customer data (recommended for better match quality)
    • Click the “Save” button. 
How to Set Up Facebook Conversions API on Shopify 7
  • Select one of your Pixels and click “Connect.”
How to Set Up Facebook Conversions API on Shopify 8

Once all steps are completed, click “Submit for Review” and wait a few seconds while the setup finalizes. You’ll receive a confirmation when your Shopify store is successfully connected to Facebook CAPI.

How to Set Up Facebook Conversions API on Shopify 9

Step 4: Finalize the Connection in Events Manager

After setting up in Shopify, you’ll need to complete the connection in Facebook Events Manager to activate the Shopify Facebook Conversions API.

Here’s how to do it:

  • Go back to Events Manager → Select the Pixel you connected earlier.
  • Click the Settings tab → Scroll down to the Conversions API section.
  • Under “Set up through a partner integration,” click “Choose a partner” → Select “Shopify” from the list.
How to Set Up Facebook Conversions API on Shopify 10

Follow the guided partner setup:

  • Connect to Shopify: 
    • In the “Choose how you share data with Meta” section, click “Go to Shopify.” A new browser tab will open showing your list of Shopify stores. Select your store.
How to Set Up Facebook Conversions API on Shopify 11

You’ll know the connection is successful if the store shows up with “Connected Product Catalog” status in the Overview tab of the Facebook & Instagram app inside Shopify.

  • Return to Events Manager tab → Click Next.
  • Verify Connection: It will display a status of Active once your store is linked successfully. Click “Next” to continue.
How to Set Up Facebook Conversions API on Shopify 12
  • Test Events: Click “Test Events” → Perform a test action (like view page or purchase) on your Shopify store. If the connection is working, you’ll see real-time events appear in the test panel.
How to Set Up Facebook Conversions API on Shopify 13
  • Finish Setup: Once confirmed, click “Finish.” Your Shopify store is now fully connected to Meta via the Shopify Facebook CAPI integration. 

Step 5: Verify, Manage, and Optimize

Once the integration is complete, your Shopify store is officially connected to Facebook’s servers via the Shopify Facebook API. Here’s how to manage and optimize it going forward:

Monitor Events in Events Manager: Visit Facebook Events Manager regularly to:

  • Check event activity under your Pixel
  • Monitor the Event Match Quality Score (aim for 6+/10)
  • Troubleshoot any warning messages or data delay.

Run Facebook and Instagram Ads: With CAPI enabled, your campaign performance will improve thanks to better attribution and less data loss. You can now:

  • Create Conversion Ads using server-side events
  • Retarget users with improved accuracy
  • Track key events like Add to Cart, Checkout, or Purchase reliably

Adjust Data Sharing Preferences (if needed): In Shopify, open the Facebook & Instagram app → Go to Settings → Data Sharing Settings. You can switch between Conservative, Enhanced, or Maximum depending on your privacy or compliance needs.

Change or Reconnect Dataset: If you ever need to update the connected Pixel or Catalog, return to the app dashboard in Shopify → Click Settings, then edit the dataset connection as needed.

How to Confirm Shopify Facebook CAPI Is Working

To verify that the Shopify Facebook Conversion API is sending data correctly, follow these steps:

  • Go to Facebook Events Manager → Select your Pixel.
  • Click the “Test Events” tab.
  • Open your Shopify store in a new tab and perform a test action (e.g., view content, add to cart, or make a test purchase).
  • Return to Events Manager and check if the events appear in real time.

If events show up with source = server, it means the Shopify Facebook API (CAPI) is working correctly. You should see both browser and server events if you’ve enabled maximum data sharing.

Also, monitor the Event Match Quality score under the Pixel’s Overview tab. A higher score (6+/10) means better data matching and stronger ad performance.

Troubleshooting Common CAPI Issues

Troubleshooting Common CAPI Issues

If your Shopify Facebook Conversions API setup isn’t working as expected, check the table below for quick fixes to common issues:

IssuePossible CauseSuggested Solution
CAPI events are not showingDataset connection failed, or data sharing is incomplete– Disconnect the dataset- Uninstall and reinstall the Facebook & Instagram app- Reconnect Pixel- Ensure “Maximum” data sharing is enabled
Duplicate eventsBoth Pixel and CAPI are firing the same eventFacebook auto-deduplicates using event_id, but check that deduplication is enabled and working
Pixel mismatchThe wrong Pixel is connected in ShopifyGo to the Facebook & Instagram app in Shopify → Settings → Ensure the correct Pixel ID is connected
Low Event Match QualityNot enough customer data sent for matchingEnable “Maximum” data sharing in Shopify and verify that hashed customer data is being sent
Delayed event reportingFacebook may take time to process server-side eventsWait a few minutes and check again in Events Manager. Real-time delay is common

Our Expert Tips for Shopify Facebook API 

Our Expert Tips for Shopify Facebook API 

At Avada, our experts have worked with hundreds of Shopify stores running Meta Ads. Here are our proven tips to keep your Shopify Facebook API setup stable and optimized:

  • Always run Pixel and CAPI together: Using both ensures redundancy. If browser-side tracking fails, server-side data still comes through.
  • Check event quality score regularly: In Events Manager, monitor the Event Match Quality score. A score above 6/10 improves optimization and ad delivery.
  • Test key events often: Simulate purchases and abandoned carts to confirm that both browser and server events fire as expected.
  • Keep all apps up to date: Regularly update the Facebook & Instagram app in Shopify and check for changes in Meta’s event handling or API updates.

Shopify Facebook API: FAQs

Does Facebook integrate with Shopify?

Yes. Shopify integrates directly with Facebook via the official Facebook & Instagram app by Meta, supporting Pixel, CAPI, and product catalog sync.

Is Facebook API free to use?

Yes. The Facebook Conversions API is free, but you’ll need an active ad account to run campaigns.

How do I set up conversion API on Facebook Shopify?

Install the Facebook & Instagram app on Shopify, connect your Meta Business account, choose data sharing settings, and finalize setup in Events Manager via partner integration.

How to connect Facebook dataset to Shopify?

During setup, Shopify auto-connects your store to a Facebook Pixel (dataset). You can verify or update this in Events Manager under Conversions API → Partner Integration → Shopify.

Bottom Line

The Shopify Facebook API is essential for accurate tracking, better attribution, and stronger ad performance, especially in a post-iOS 14 world. By setting up the Facebook Conversions API on Shopify properly, you gain deeper visibility into your customer journey and maximize your ad spend.

If you need more tips to scale your Meta Ads with Shopify, explore more expert guides at Avada and take your store to the next level.

Sam Nguyen is the CEO and founder of Avada Commerce, an e-commerce solution provider headquartered in Vietnam. He is an expert on the Shopify e-commerce platform for online stores and retail point-of-sale systems. Sam loves talking about e-commerce and he aims to help over a million online businesses grow and thrive.