Developers & API - Northbeam

Northbeam’s APIs for sending data in and getting data out — orders, spend, and exports — plus the MCP server for querying your data in natural language. Start with Using the API for authentication and environments, then jump to the API your task needs.

What you’ll do

Send orders and spend programmatically
Export attribution data, metrics, and breakdowns to your own systems
Authenticate and test in UAT before touching production

Using the API

Using the API Authentication Environments Errors

Orders API

Orders API Order Definition Hashing Customer Data POSTUpsert a list of orders to Northbeam GETFetch a list of orders PATCHPartially update existing orders POSTAdd aliases to existing orders POSTUpsert a list of orders to Northbeam (V1, deprecated)GETFetch a list of orders (V1)

Spend API

Spend API Best Practices and Limits GETList spend records POSTUpsert one or multiple spend records DELDelete a spend record GETList spend records (hourly)POSTUpsert one or multiple hourly spend records DELDelete a spend record (hourly)

Data Export API

Data Export Exporting To GCS Exporting To S3 Rate Limits POSTCreate a data export config GETFetch a data export result GETFetch all available metrics GETFetch all labels available for breakdown GETFetch all available attribution models

Next section: Playbooks