API Reference

Email Addresses

Email addresses are the core resource. Each one gets a unique @serssly.com address for receiving newsletters and a corresponding RSS feed URL.

List email addresses

GET /api/v1/email_addresses

Request


$ curl https://serssly.com/api/v1/email_addresses \
    -H "Authorization: Token $SERSSLY_API_KEY"

Response 200


{
  "email_addresses": [
    {
      "id": 1,
      "name": "Tech Newsletters",
      "rss_token": "wKx9vBp7...",
      "folder_id": null,
      "created_at": "2026-04-03T..."
    }
  ],
  "pagination": { "limit": 20, "next_url": null, "previous_url": null }
}

Create an email address

POST /api/v1/email_addresses

Parameter	Type	Description
name	string	Optional label for the address
folder_id	integer	Optional folder to organize into

Request


$ curl -X POST https://serssly.com/api/v1/email_addresses \
    -H "Authorization: Token $SERSSLY_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"name": "Tech Newsletters"}'

Response 201


{
  "id": 1,
  "name": "Tech Newsletters",
  "rss_token": "wKx9vBp7...",
  "folder_id": null,
  "created_at": "2026-04-03T..."
}

Returns 402 if you've reached your plan's email address limit.

Update an email address

PATCH /api/v1/email_addresses/:id

Request


$ curl -X PATCH https://serssly.com/api/v1/email_addresses/1 \
    -H "Authorization: Token $SERSSLY_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"name": "Renamed Feed", "folder_id": 2}'

Delete an email address

DELETE /api/v1/email_addresses/:id

Deletes the address and all its received emails. Returns 204 No Content.