MadKudu

MadKudu Ingestion API

The Ingestion API from MadKudu — 3 operation(s) for ingestion.

GitHub OpenAPI

Operations 3

POST /ingestion/upload-json Import data via API #
POST /ingestion/generate-upload-url Generate Upload Url #
POST /ingestion/confirm-upload Confirm Upload #

Documentation

📖
Documentation
https://developers.madkudu.com/api
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/madkudu/refs/heads/main/authentication/madkudu-authentication.yml
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/madkudu/refs/heads/main/rate-limits/madkudu-rate-limits.yml
📖
Documentation
https://developers.madkudu.com/legacy-api

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/madkudu/refs/heads/main/openapi/madkudu-ingestion-api-openapi.yml

Other Resources

🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/madkudu/refs/heads/main/errors/madkudu-problem-types.yml
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/madkudu/refs/heads/main/conventions/madkudu-conventions.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/madkudu/refs/heads/main/data-model/madkudu-data-model.yml
🔗
Sandbox
https://raw.githubusercontent.com/api-evangelist/madkudu/refs/heads/main/sandbox/madkudu-sandbox.yml
🔗
Plans
https://raw.githubusercontent.com/api-evangelist/madkudu/refs/heads/main/plans/madkudu-plans-pricing.yml
🔗
SDKs
https://raw.githubusercontent.com/api-evangelist/madkudu/refs/heads/main/packages/madkudu-packages.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/madkudu-ingestion-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

madkudu-ingestion-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Mad Ingestion API
  version: 0.0.0
servers:
- url: https://madapi.madkudu.com
  description: Production server
  variables: {}
- url: https://madapi.wisekudu.com
  description: Staging server
  variables: {}
security:
- ApiKeyAuth: []
tags:
- name: Ingestion
paths:
  /ingestion/upload-json:
    post:
      operationId: Ingestion_uploadJson
      summary: Import data via API
      description: Directly upload contact, account, or activity data in JSON format through the API for immediate processing.
      parameters: []
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonUploadResponse'
      tags:
      - Ingestion
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/JsonUploadRequest'
  /ingestion/generate-upload-url:
    post:
      operationId: Ingestion_generateUploadUrl
      summary: Generate Upload Url
      description: Generate a presigned URL for file upload.
      parameters: []
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UploadResponse'
      tags:
      - Ingestion
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UploadRequest'
  /ingestion/confirm-upload:
    post:
      operationId: Ingestion_confirmUpload
      summary: Confirm Upload
      description: Confirm that a file has been uploaded.
      parameters: []
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConfirmUploadResponse'
      tags:
      - Ingestion
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConfirmUploadRequest'
components:
  schemas:
    UploadResponse:
      type: object
      required:
      - upload_url
      - file_key
      properties:
        upload_url:
          type: string
          description: Presigned URL for file upload
        file_key:
          type: string
          description: Unique file key for the uploaded file
    UploadRequest:
      type: object
      required:
      - stream
      - content_type
      - content_encoding
      properties:
        stream:
          allOf:
          - $ref: '#/components/schemas/AcceptedStream'
          description: Stream type for the data
        content_type:
          allOf:
          - $ref: '#/components/schemas/ContentType'
          description: Content type of the file to upload
        content_encoding:
          allOf:
          - $ref: '#/components/schemas/ContentEncoding'
          description: Content encoding for the file
    JsonUploadRequest:
      type: object
      required:
      - stream
      - data
      properties:
        stream:
          allOf:
          - $ref: '#/components/schemas/AcceptedStream'
          description: Stream type for the data
        data:
          anyOf:
          - type: array
            items:
              $ref: '#/components/schemas/Contact'
          - type: array
            items:
              $ref: '#/components/schemas/Account'
          - type: array
            items:
              $ref: '#/components/schemas/ContactEvent'
          - type: array
            items:
              $ref: '#/components/schemas/AccountEvent'
          description: Data array - contents depend on stream type
      description: Request model for direct JSON upload
    JsonUploadResponse:
      type: object
      required:
      - status
      - message
      - file_key
      properties:
        status:
          type: string
          description: Upload status
        message:
          type: string
          description: Upload message
        file_key:
          type: string
          description: Generated file key for the uploaded data
      description: Response model for JSON upload
    ContentType:
      type: string
      enum:
      - application/jsonl
      description: Content types for customer data
    Account:
      type: object
      required:
      - account_id
      - domain
      - account_properties
      properties:
        type:
          type: string
          enum:
          - account
          description: Type identifier for account
          default: account
        account_id:
          type: string
          description: Unique identifier for the account
        domain:
          type: string
          description: Domain of the account
        account_properties:
          type: object
          unevaluatedProperties: {}
          description: Additional account properties
      description: Account model for ingestion
    ConfirmUploadRequest:
      type: object
      required:
      - file_key
      properties:
        file_key:
          type: string
          description: File key from the upload response
    ConfirmUploadResponse:
      type: object
      required:
      - status
      - message
      properties:
        status:
          type: string
          description: Upload confirmation status
        message:
          type: string
          description: Confirmation message
    Contact:
      type: object
      required:
      - contact_id
      - email
      - contact_properties
      properties:
        type:
          type: string
          enum:
          - contact
          description: Type identifier for contact
          default: contact
        contact_id:
          type: string
          description: Unique identifier for the contact
        email:
          type: string
          description: Email address of the contact
        contact_properties:
          type: object
          unevaluatedProperties: {}
          description: Additional contact properties
      description: Contact model for ingestion
    ContactEvent:
      type: object
      required:
      - event_id
      - contact_id
      - event
      - event_timestamp
      - event_properties
      properties:
        event_type:
          type: string
          enum:
          - contact_event
          description: Event type identifier
          default: contact_event
        event_id:
          type: string
          description: Unique identifier for the event
        contact_id:
          type: string
          description: Contact identifier for the event
        event:
          type: string
          description: Event name
        event_timestamp:
          type: string
          format: date-time
          description: Timestamp when the event occurred (ISO 8601 format)
        event_properties:
          type: object
          unevaluatedProperties: {}
          description: Additional event properties
      description: Contact event model for ingestion
    AccountEvent:
      type: object
      required:
      - event_id
      - account_id
      - event
      - event_timestamp
      - event_properties
      properties:
        event_type:
          type: string
          enum:
          - account_event
          description: Event type identifier
          default: account_event
        event_id:
          type: string
          description: Unique identifier for the event
        account_id:
          type: string
          description: Account identifier for the event
        event:
          type: string
          description: Event name
        event_timestamp:
          type: string
          format: date-time
          description: Timestamp when the event occurred (ISO 8601 format)
        event_properties:
          type: object
          unevaluatedProperties: {}
          description: Additional event properties
      description: Account event model for ingestion
    ContentEncoding:
      type: string
      enum:
      - gzip
      description: Content encodings for customer data
    AcceptedStream:
      type: string
      enum:
      - account
      - account_event
      - contact
      - contact_event
      description: Accepted streams for customer data
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key