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.tomlRead 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
Source: topoteretes/cognee