Create a feed subscription

Once an endpoint is registered you can create feed subscriptions attached to that endpoint.

therssproject servers will listen for new entries on the feed and send webhook events to the endpoint with the new entries.

A feed subscription can be created using the dashboard in or by making an API request using the previously created API Key.

To create a feed subscription using the API, use the following curl example with the required attributes.


  • endpoint: the ID of the endpoint to send updates to
  • url: the feed url
  • metadata (optional): a JSON payload to be send in the webhooks events

Request example:

curl \
  -X POST \
  -H "Authorization: <api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "endpoint": "62a553394a314dde29ceee6f",
    "url": "",
	  "metadata": { "foo": "bar" }

Response example:

  "id": "62c8b13b32fc930766ba23c7",
  "application": "62a3dfc09b9f7bee4fd5fa66",
  "url": "",
  "feed": "62bd190dba7e012d91a9dd58",
  "endpoint": "62a553394a314dde29ceee6f",
  "metadata": { "foo": "bar" },
  "created_at": "2022-07-08T22:35:39.765Z"