Connect System.io to Metrikia

Goal

By the end of this guide, your System.io contacts will be synced into Metrikia and their funnel position inferred from their tags, ready to cross-reference with your ad spend for real ROAS.

Prerequisites

• An active Metrikia account
• A System.io account with contacts
• Admin rights on your System.io account (to generate an API key)

Step 1: Get your System.io API key

1. Sign in to your System.io account
2. Open Settings > Public API keys
3. Create a new API key and copy it
4. Keep this key handy for the next step

Pro tip: Give the key a clear name (for example "Metrikia") so you can find it again later.

Step 2: Connect System.io in Metrikia

1. Go to Settings > Integrations (/app/settings)
2. Click the System.io tile > Connect
3. Paste your API key
4. Confirm: Metrikia validates the connection right away

Step 3: Map your tags to lead statuses

System.io has no native status field: a contact's funnel position is carried by its tags. The configuration wizard walks you through linking them to Metrikia statuses.

1. Open the configuration wizard (/app/integrations/{id}/configure)
2. Metrikia analyzes a sample of your contacts and lists the tags it finds
3. For each relevant tag, pick the matching Metrikia status (New, Contacted, Appointment booked, Won, etc.)
4. Save

Good to know: if a contact carries several mapped tags, Metrikia keeps the most advanced funnel stage. A contact tagged both "lead" and "customer" is therefore counted as a customer.

Expected result

Your contacts appear in CRM with the right status. Syncing continues automatically: the system refreshes your contacts on a regular basis, you do not have to trigger anything.

Common issues

"Invalid API key"

• Make sure the key was copied in full, with no leading or trailing space
• Regenerate a key in System.io if in doubt

Statuses stay on "New"

• The tag mapping is not saved yet: go back through the configuration wizard
• The contact carries no mapped tag: add the missing tag to the mapping list

Revenue does not show up

• System.io does not expose a generic sales list. To pull an amount, map the desired amount field in the "custom fields" step of the wizard.

Next step

Once your statuses are mapped, open ADS to see your campaigns cross-referenced with real sales. Missing a feature? Suggest it in Ideas and Roadmap from /app/settings.