Connect Hyros and its attribution shows up next to your Meta ad sets: as columns in Ads Manager and as metrics your Agent Tasks can act on. There's no API key to copy. You approve Koast in Hyros and come straight back.

Before you start

• You need a Hyros account you can approve apps on.
• The active ad account in Koast must be a Meta ad account. Hyros attributes against your Meta ads, so without one there's nothing to match.
• You need access to integrations in Koast. Integrations are set per ad account, so connect Hyros while the right ad account is active.

Connect Hyros

1. Open Settings, then Hyros under Integrations.

2. Select Connect Hyros.

3. Approve Koast in Hyros.

4. You're sent back to Koast. If your organization has more than one ad account, pick the one this Hyros account belongs to.

When it's done, you'll see "Hyros is connected." with Go to dashboard. Attribution arrives with the next nightly sync.

Back in Settings, Hyros, the tab shows:

• Attribution Settings: the model is Last touch (paid), applied at the Meta ad set level, and Data refresh is Daily.
• Data Status: for example "1,284 ad-set days stored." Right after connecting, it says it's waiting for the first nightly sync.

See Hyros in Ads Manager

1. Open Ads Manager and select Columns above the grid.

2. Under Hyros, tick the columns you want: Sales, Revenue, Cost, ROAS and ROI.

Hyros attributes at the ad set level, so the numbers show on ad set rows. Campaign and ad rows show the note "Hyros attributes at ad-set level" instead.

Use Hyros in Agent Tasks

In a Monitor rule, pick a Hyros metric to watch: Sales, Revenue, Cost, CPA, ROAS, ROI or AOV. The Hyros group is marked Beta in the metric picker. See Monitor rules reference.

Good to know

• Recent days keep changing. Hyros redistributes attribution after the fact, so every night, at 4:30 UTC, Koast fetches recent days again. Yesterday's numbers can still move.
• Meta ad accounts only. Hyros data doesn't cover Koast ad accounts.
• If Hyros stops syncing, the tab says "Hyros rejected the stored key. Reconnect to continue syncing." Select Reconnect and approve Koast again.

Disconnect Hyros

In Settings, Hyros, select Disconnect under "Disconnect integration" and confirm. Koast stops fetching attribution from Hyros. Data already stored stays readable, but anything that uses Hyros data stops working until you reconnect.