Marketing data
Hyros for agents
Ad attribution your agent can actually read: spend, ROAS, lead journeys and marginal cost per acquisition.
What it can do
Ad attribution your agent can actually read: spend, ROAS, lead journeys and marginal cost per acquisition. 12 tools in total, listed below in full.
How you connect it
A Hyros API key.
Every tool an agent gets
Read from the live integration, so this is what an agent can actually call.
| Tool | What it does |
|---|---|
| hyros_get_ad_accounts | List the ad accounts connected to this Hyros account. |
| hyros_get_sources | List source links (the tracked ad sources) for the account. |
| hyros_get_roas | ROAS for ONE ad, ad set, campaign or ad account over a date range, from the cash Hyros attributes to it. |
| hyros_get_attribution_report | Multi-entity ads attribution report. |
| hyros_get_marginal_cac_curve | What the next customer costs at every daily spend level this entity has actually run at, and the spend level past which the next dollar is wasted. |
| hyros_get_sales | Retrieve attributed sales. |
| hyros_get_leads | Retrieve leads by join date, last-updated date, email, phone, tag, stage or id. |
| hyros_get_lead_journey | The full click and attribution journey for one or more leads: their sales, calls, carts, subscriptions and linked leads. |
| hyros_get_calls | Retrieve attributed sales calls, optionally filtered to qualified ones. |
| hyros_get_subscriptions | Retrieve subscriptions and their states. |
| hyros_get_custom_costs | Retrieve custom (non-ad) costs recorded in Hyros. |
| hyros_get_domains | List the verified domains on this Hyros account. |
Workflows that need Hyros
Already written. Connect it, pick an agent, and it runs on the cadence shown.
| Workflow | Runs | Approval |
|---|---|---|
| Lead Journey Lookup Where a specific customer actually came from: every click, call, cart and subscription on their record, in order. Answers "what did this person touch before they bought" for one lead, or for everyone who bought in the last day. | Every day 9:00am | Not required |
| Ad Performance Brief Daily spend, attributed revenue and ROAS by campaign, diffed against the trailing baseline, with the movers explained rather than just listed. | Every day 9:00am | Not required |
| Tracking Health Check Finds revenue arriving with no attributed source and the specific URLs causing it, before the numbers everyone is optimising against quietly stop meaning anything. | Mondays 10:00am | Not required |
Connected at the same time
Put an agent on Hyros.
Connect it during the trial, give one agent one job, and see the first result the same day.
Start the trial All 15 integrations