Feeds

The Feeds module (feeds) posts listings to Discord channels: new internship and new grad roles from GitHub job lists, and upcoming hackathons. It is in the Webhooks category and starts off. Each feed reads one source on a schedule and posts the new items to one Discord webhook. Org events such as errors use event webhooks, not feeds.

flowchart LR
  careers["submodule careers: presets"] --> feeds
  feeds["feeds: github_jobs and hackathons feeds, feeds.run_due"] --> discord["Discord webhooks"]

Kinds of feed

If the module is off for the org, its feeds do not show and do not run.

Kind	Code	Source	Item key
`github_jobs`	`github_jobs.py`	The job table in a GitHub repo's README (Company, Role, Location, Application/Link, Date Posted), as in the internship and new grad lists	A hash of company, role, first location, and link with no tracking parameters
`hackathons`	`hackathons.py`	Hack Club, Euro-Hackathons and Hackalist	The event name, in lowercase

The careers submodule gives ready feeds of both kinds. When the org subscribes to it, the Feeds card on Explore lists them. Add on a feed opens the page of its kind with the new feed form filled. A feed you make is your own: it counts against no shared limit.

Before 2026-10, the two kinds were the modules job_webhook and hackathon_webhook. Migration a3c5e7f9b1d3 turned feeds on for each org that had either one on.

The first run of a feed records all current items and posts none. Thus a new feed does not post hundreds of old listings. Later runs post up to 25 new items, with half a second between posts. If a post fails, the item stays new and goes out on the next run.

Dashboard

The Job alerts page (job-alerts) shows the github_jobs feeds. The Hackathons page (hackathons) shows the hackathons feeds. Both are pages of the Feeds module. The old path alerts opens the Job alerts page. On each page:

New feed > Start from fills the form from a feed of that kind in a submodule the org subscribes to.
?new=<submodule>/<feed> opens the new feed form with that feed.
Each feed has pause, run now, delete, and its history.

Routes

All routes are under /api/feeds/<org>, for officers of the org. When the Feeds module is off, a route for a feed returns 404.

Route	Does
`GET /feeds`	Each feed with its schedule, last run, last error and number of posts
`GET /feeds/<key>`	One feed
`PUT /feeds/<key>`	Creates (201) or updates (200) a feed. Body below
`DELETE /feeds/<key>`	Deletes the feed, its posted items and its webhook secret
`GET /feeds/<key>/history`	The last 50 runs (time, duration, items found, new and posted, error) and the last 50 items the feed posted or recorded
`POST /feeds/<key>/run`	Starts a run now and returns 202. With `{"post_existing": true}`, a first run posts the current items
`GET /presets`	The feeds that the submodules the org subscribes to offer, when Feeds is on, with `module`, the `kind` and `config` to send to `PUT /feeds/<key>`, and `added` when the org has a feed with that key

{
  "kind": "github_jobs",
  "webhook_url": "https://discord.com/api/webhooks/<id>/<token>",
  "every_hours": 3,
  "enabled": true,
  "config": {"repo": "vanshb03/Summer2026-Internships", "label": "Internship"}
}

The key has lowercase letters, digits and dashes, 40 characters or fewer.
A new feed needs webhook_url. Platform keeps it as the org secret alert_webhook_<key> and never returns it. A route shows only if it is set.
You cannot change kind after you create the feed.
every_hours is 1 to 168, default 3.

github_jobs config:

Field	Default	Does
`repo`	required	`owner/name` on GitHub
`branch`	`main`	The branch to read
`path`	`README.md`	The Markdown file with the table
`label`	`Job`	The word in the post title, such as Internship
`skip_closed`	`true`	Leaves out roles marked closed
`max_age_days`	`2`	Leaves out rows with an older Date Posted. 0 turns off this check

hackathons config:

Field	Default	Does
`sources`	all three	One or more of `hackclub`, `euro_hackathons`, `hackalist`
`min_days_ahead`	`0`	Leaves out events that start sooner
`max_days_ahead`	`90`	Leaves out events that start later

A hackathon feed fails only if all its sources fail. MLH and Devpost refuse automated requests, so they are not sources.

Tools

feeds.list, feeds.presets, feeds.history, feeds.save, feeds.run and feeds.delete (confirm) need the scope feeds:manage. They need the Feeds module on.

Schedule

The feeds.run_due job runs every 15 minutes. It runs each enabled feed whose every_hours has passed since its last run, if the Feeds module is on for the org. A failed run keeps its reason in last_error. Each run, scheduled or started with Run now, adds a row to alert_runs; Platform keeps the last 50 for each feed. The next run occurs at the next due time.

Move from a webhook script

If the module is off for the org, turn it on: flask --app main org modules <prefix> --on feeds.
Make a Discord webhook for each channel, or use the webhooks you have.
PUT one feed for each source. The first run records the current listings, so nothing is posted two times.
Stop the schedule of the old script.

Kinds of feedCopy Anchor Link

DashboardCopy Anchor Link

RoutesCopy Anchor Link

ToolsCopy Anchor Link

ScheduleCopy Anchor Link