Delete a newsletter

Newsletter objects that you create on IndyWriters are administered by you. Only in exceptional circumstances - such as abuse of the system - will IndyWriters get involved. As such, you may delete newsletters at will.

Deletion is permanent, unrecoverable, and cascades - data associated with the newsletter will also be deleted.

              
  curl -X DELETE https://indywriters.com/api/newsletters/{reference}/ \
    -H "Username: AwesomeYou" \
    -H "API-Key: UR70776441awe50me"
              
            

Read newsletters

You can read all newsletters that you manage with basic GET requests. Just include a newsletter's reference to be specific.

              
  curl -X GET https://indywriters.com/api/newsletters/ \
    -H "Username: AwesomeYou" \
    -H "API-Key: UR70776441awe50me"
              
            

Read a specific newsletter

              
  curl -X GET https://indywriters.com/api/newsletters/{reference}/ \
    -H "Username: AwesomeYou" \
    -H "API-Key: UR70776441awe50me"
              
            

Update a newsletter

All updates are subject to the same review as new objects - a manual check to ensure the system is safe for all users. As such edits are made to a staging model - note the api/newsletter-edits route.

Updating is done via PATCH requests, and all six fields can be edited.

              
  curl -X PATCH https://indywriters.com/api/newsletter-edits/[reference]/ \
    -H "Username: AwesomeYou" \
    -H "API-Key: UR70776441awe50me" \
    -F "title=New Title" \
    -F "tagline=I just had to change the tagline" \
    -F "url=https://awesomenewsletter.blog" \
    -F "logo=URL to an image resource" \
    -F "topic_list=tech, ai, online culture" \
    -F "external_id=1754"
              
            

Read newsletter click data

Newsletter writers will probably like to see evidence that their cross-promotions are working. UTM params are in place to show that referrals have come from IndyWriters and your platform, but it's useful for you to be able to present data to your users.

The currency of IndyWriters is clicks - i.e. readers of one newsletter clicking through to see that of a cross-promotion partner. You can read click data using the following curl, where the "days" param indicates how many days before present the data should include (default=30):

You can also see clicks for all newsletters your platform manages by removing the reference.

              
  curl -X GET https://indywriters.com/api/clicks/{reference}/?days=20/ \
    -H "Username: AwesomeYou" \
    -H "API-Key: UR70776441awe50me"
              
            

The expected response will look like the below, where origin is the newsletter that referred and destination is the newsletter that received. References for origin and destination will only be given if the newsletter is administered by one of your users, othewise they are set to null to prevent data leakage between platforms:

            
  [
    {
      "origin_reference":null,
      "origin_url":"https://origin_url.com",
      "destination_reference":"kDpaqSC",
      "destination_url":"https://destination_url.com",
      "created":"2025-07-15T09:55:59.633994Z"
    }
    {
      "origin_reference":"JryiRe",
      "origin_url":"https://origin_url.com",
      "destination_reference":"kDpaqSC",
      "destination_url":"https://destination_url.com",
      "created":"2025-07-15T09:55:59.633994Z"
    }
  ]