#4711·cognee

Hackathon [Feature]: Add Postman data-source connector

Author: NMZivkovicCreated Aug 28, 2026Updated Sep 15, 2026
Labelsenhancementgood first issueINTEGRATIONShackathon

Problem Statement

cognee has five data-source connectors today (confluence, gmail, google-drive, notion, slack) against roughly 120 planned. Data sources are the thinnest surface in the project.

Postman is on the roadmap and has no connector.

Proposed Solution

Add a postman connector under packages/connector/postman/ in cognee-community, following the shape of the five existing connectors.

  • Auth: API key
  • Ingest: collections, request descriptions, and documentation
  • Incremental sync: collection updatedAt
  • Forget-on-delete: deleting upstream must remove the record from the graph on the next sync

Watch out for

Collections are deeply nested JSON — flatten to one node per request or the graph mirrors the JSON tree.

Package layout to follow

packages/connector/postman/
├── README.md
├── cognee_community_connector_postman/
│   ├── __init__.py
│   └── postman.py
├── examples/
├── tests/
└── pyproject.toml

Read packages/connector/notion/ first — it is the closest working reference.

Acceptance Criteria

  • A user connects via API key and selects what to ingest
  • Selected content is ingested and searchable in cognee
  • Incremental sync picks up only what changed since the last run
  • Deleting the source upstream removes it from the graph on the next sync
  • README with setup steps and a runnable example under examples/
  • Tests covering the ingest path and the incremental cursor

Context

Part of the cognee hackathon connector push. Difficulty: Beginner friendly (E) — auth is an API key or token; no OAuth dance, no account gatekeeping