Ingestion API - Send your custom signals

Push your own customer & activity data into MadKudu in real time, then use it everywhere—Sales Copilot, AI Scoring, MadKudu MCP, etc.

The Ingestion API allows you to send custom customer or activity data into MadKudu in real time. It’s ideal for ingesting product usage events, marketing actions, or any proprietary/purchased signals—especially when native integrations (e.g. Salesforce, HubSpot) are not an option.

Whether it’s product usage from your app, marketing events from custom systems, or any proprietary or purchased signals, this API gives you a single, secure, schema-flexible way to get your data into the MadKudu pipeline.

When to use the Ingestion API

Use this API when you need to send data to MadKudu

that can’t be synced through existing native integrations (see integration list)
where going through Snowflake, BigQuery or S3 is a heavier lift
If your data is already piped into Segment or your warehouse, we recommend starting with those integrations.

Please follow the Ingestion API doc here

Supported data objects

Type

Description

contact event

action or behavior (e.g. “signed_up”) tied to a person

account event

action or behavior (e.g. “new funding round”) tied to a company

contact

Update to person-level attributes

account

Update to company/account-level attributes

How the Ingestion API works

There 2 ingestion modes to choose from

Lightweight JSON file upload directly to the API (payloads up to 1 MB)
Heavyweight JSON file uploads to a S3 URL (gzip file up to 2 GB)

Format

Each ingestion mode expects the same record format.

Files must follow the schema defined in the Upload JSON Schema Reference or they will be rejected

Please follow the Ingestion API doc here