Connect Northbeam to Your AI Agent

Give AI the dates and campaign identifiers you want to compare, and ask for a spending breakdown.

5 tools API key

Try a Northbeam Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill Northbeam

Compare campaign spend

Read spend for a chosen period and summarize differences between campaigns.

/oo Northbeam: Read Northbeam daily spend from [start date] to [end date] for ad account [ID]. Compare campaign totals and identify the highest-spend days.

Start Working with Northbeam

Install OOMOL

Set up oo CLI and the oo Skill in your agent.
Install OOMOL →
Connect Northbeam

Connect your Northbeam API key and the paired Data-Client-ID from Settings > API Keys.
Connect Northbeam →
Give Your Agent a Task

Use /oo with the pages to read, the changes to make, and where to save the result.
Connection Guide →

Choose Your Agent

Codex Claude Code Cursor Hermes

A Northbeam API key and its Data-Client-ID.

Northbeam Tools

The integration reads daily and hourly spend records and lists available metrics, attribution models, and breakdown definitions. It does not export attributed conversion reports.

Spend and export definitions

Read daily or hourly spend and inspect available metrics, models, and breakdowns.

5 tools

List Metrics

List the metrics available for Northbeam data exports.

northbeam.list_metrics

List Attribution Models

List the attribution models available for Northbeam data exports.

northbeam.list_attribution_models

List Breakdowns

List the breakdown keys and values available for Northbeam data exports.

northbeam.list_breakdowns

List Spend

List paginated Northbeam daily spend records.

northbeam.list_spend

List Hourly Spend

List paginated Northbeam hourly spend records.

northbeam.list_hourly_spend

Frequently Asked Questions

Can I narrow the spend comparison?

Yes. Specify an ad account, campaign, ad set, or ad ID along with the date range.

Can I examine spending within a day?

Hourly spend accepts a start and end date-time. Include your intended time zone when describing the period.

Does listing attribution models calculate conversions?

No. It lists model definitions available for exports; the exposed data reads cover advertising spend.