Meta CAPI beginner setup

How to set up Meta CAPI without getting lost

A clean setup starts by choosing one real conversion and one place where it happens. Then connect the correct Meta dataset, create a secure server event, and test the event before relying on campaign reports.

Updated July 2026 8 min read Practical setup guide
Quick answer

What to do

To set up Meta CAPI, choose the event you want to track, confirm the correct Meta dataset, create an access token, connect the website or CRM to a secure server endpoint, send the event with accurate data, and verify it in Meta Test Events. For GoHighLevel, use the exact form, calendar, or workflow that represents the conversion.

1. Choose one conversion first

Do not begin with code. Begin with the business action. Decide whether the setup should report a Lead, Schedule, Purchase, QualifiedLead, or another event.

For GoHighLevel, select the exact form or calendar. A generic workflow that fires for every form makes testing and reporting harder.

  • Contact or estimate form: usually Lead
  • Completed appointment booking: usually Schedule
  • Paid checkout: usually Purchase
  • Qualified pipeline stage: QualifiedLead when it truly happens

2. Connect the correct Meta dataset

Open Meta Events Manager and confirm the dataset belongs to the correct business and ad account. Copy the dataset ID and create an access token for the server connection.

Keep the access token outside the public page code. The browser should send the event to your protected endpoint, and the endpoint should communicate with Meta.

  • Correct business portfolio
  • Correct dataset ID
  • Access token stored as a secret
  • Correct event name and source website

3. Install the event and test a real conversion

Install the generated script on the exact page or form where the conversion happens. Then complete the real form or booking while Meta Test Events is open.

A test should confirm delivery, event name, source URL, matching fields, and deduplication. A successful API response alone does not prove the event contains useful information.

  • Publish the page after installing the script
  • Use a fresh test contact
  • Complete the real conversion
  • Inspect the server event in Test Events
  • Check Diagnostics after production traffic begins
Before you publish

Meta CAPI setup checklist

01Define one real conversion

02Confirm the Meta dataset ID

03Create and protect the access token

04Install the event on the exact page or form

05Test a real submission or booking

06Confirm deduplication when the Pixel also sends the event

Frequently asked questions

Common questions about this setup

How to setup Meta CAPI?+

Choose the conversion, connect the correct dataset, create a protected server connection, install the event, and test a real conversion in Meta Events Manager.

Do I need a developer to set up Meta CAPI?+

A custom server build usually needs technical work. A managed tool can reduce the task to entering the Meta details and installing one generated script.

Can I set up Meta CAPI with GoHighLevel?+

Yes. Use the exact GoHighLevel form, calendar, or workflow that represents the conversion and keep the original visit data connected to the contact.

What should I set up first, Lead or Schedule?+

Start with the earliest meaningful conversion used for campaign optimization. Add Schedule separately when a completed booking is important to the business.

Official references

Use these official references when checking the current Meta setup and account screens.

Keep learning

Related conversion tracking guides

Simple CAPI workspace

Turn the answer into a working Meta conversion.

Choose Lead or Schedule, paste one protected script on the intended page, and verify the real conversion.

Create your script