# HYROS Installation: Kartra

## IMPORTANT NOTES BEFORE STARTING

**Read these warnings first:**

1. **Use "Embed Facebook Ads Tracking Code" only** - Do NOT paste the script into the "Head tracking code" section. Only the Embed Facebook Ads Tracking Code section works.

2. **Embedded checkout forms required** - To track sales, your Kartra products must use an embedded checkout form on a page that has the HYROS script installed.

---

## REQUIREMENTS - Collect Before Starting

| Item | Ask User |
|------|----------|
| Kartra Admin Access | "Do you have admin access to your Kartra account?" |
| Checkout Type | "Do your Kartra products use embedded checkout forms?" |

---

## STEP 1: Install Universal Script on Pages

**If automating:**
In HYROS, get the Universal Script from Tracking → Insert Code. In Kartra, go to My Pages. Select a page and click Edit. In the page editor, go to Settings → Tracking Code. Paste the script into "Embed Facebook Ads Tracking Code" (NOT Head tracking code). Click Apply. Repeat for every page.

**If guiding user:**
1. "In Hyros, go to Tracking → Insert Code."
2. "Click Copy Script."
3. "In Kartra, go to My Pages."
4. "Select the page → click Edit."
5. "In the page editor, go to Settings → Tracking Code."
6. "Paste the script into 'Embed Facebook Ads Tracking Code'."
7. "Click Apply."
8. "Repeat for every page you want to track."

**Important:** Do NOT paste it into the "Head tracking code" section — only "Embed Facebook Ads Tracking Code" works.

→ Confirm: "Is the script added to all your Kartra pages?"

---

## STEP 2: Create the Integration in HYROS

**If automating:**
In HYROS, go to Settings → Integrations. Search for Kartra and click Create Integration. Name it (e.g., "Kartra"). Click Configure, then Get Webhook and copy the webhook URL.

**If guiding user:**
1. "In your Hyros account, go to Settings → Integrations."
2. "Search for Kartra and click Create Integration."
3. "Name your integration (any name works, e.g. 'Kartra')."
4. "Click Configure, then click Get Webhook and copy the webhook URL."

→ Confirm: "Do you have the HYROS webhook URL?"

---

## STEP 3: Configure Webhook in Kartra

**If automating:**
In Kartra, go to My Integrations → API → My API. Open Outbound API and click Change. If Outbound API is not enabled, activate it first. Click Add to create a new webhook. Paste the HYROS webhook URL. Select event "Customer Buys Product". Choose the funnel/events to track. Set Price Point to "Any Price Point". Click Add.

**If guiding user:**
1. "In Kartra, go to My Integrations → API → My API."
2. "Open Outbound API and click Change. If Outbound API is not enabled, activate it first."
3. "Click Add to create a new webhook."
4. "Paste the Hyros webhook URL."
5. "Select the event Customer Buys Product."
6. "Choose the funnel and events you want to track."
7. "Set Price Point to Any Price Point."
8. "Click Add."

→ Confirm: "Is the Kartra webhook configured?"

---

## STEP 4: Add More Events (Optional)

Repeat the same webhook setup steps to add additional products or events using the same webhook URL.

---

## TROUBLESHOOTING

### Script not working?
- Make sure you're using "Embed Facebook Ads Tracking Code" NOT "Head tracking code"
- Script must be on each individual page in Kartra

### Sales not tracking?
- Products must use embedded checkout forms
- Checkout must happen on a page WITH the HYROS script
- Verify webhook is configured for "Customer Buys Product"

### Outbound API not available?
- You may need to enable it in your Kartra API settings first

---

## Source
Synced from: docsContent.ts (kartraGuide)
Last synced: 2026-01-03