~netlandish/links

LinkTaco supports posting your links via email. It's an easy, quick process and quite powerful once you get the hang of it. This is a paid account feature so you must have at least one paid organization with write access to use this.

#Enable the feature

To enable the feature you simply do the following:

  1. Login to your account and click the "Settings" option on the left menu
  2. Click the "Actions" button in the top right, then click "Edit Profile"
  3. On the next screen simply check the "Enable email posting" box and click "Save".

You will be redirected back to the settings screen but now you will have an email address you can use to post. It will look something like post+abcdefghi0@linktaco.com. DO NOT share this email address with anyone. Anyone posting to it will be able to post to your account.

If you accidentally leak this email simply go back to "Edit Profile" above and click the "Regenerate code" box and hit "Save". This will generate a new email address (code) to use for your account and invalidate the old one.

It is literally as simple as sending an email. However there are a few gotchas you should know first.

  1. The email MUST contain a text part. The script will not process HTML only emails so please ensure it has a plain text part.
  2. The email subject will be the bookmark (saved link) title.
  3. In the email body there can be three types of lines:
  • The URL you want to save
  • Action lines (more on this below)
  • Description lines
  1. All lines in the email that are not a URL or Action line will be added to the description, in the order they are read.
  2. The script will stop parsing the email after two consecutive blank lines (this avoids processing any email signatures, usually).

Writing the email is simple. You can place lines in any order you wish but here is an example email:

Subject: Hacktivist deletes white supremacist websites live onstage during hacker conference

https://techcrunch.com/2026/01/05/hacktivist-deletes-white-supremacist-websites-live-on-stage-during-hacker-conference/
So cool! Hackers deleted a white supremacist website during a live demo at a
hacker conference.

tags: hacker, conference, live on stage, cool
starred: true


---
Sent from my iPhone

Note, that the from the line of --- and onward will be completely ignored because it comes after 2 consecutive blank lines. Again, it does not matter the order of the lines except in the case of description lines. If the line is not an Action line (in the example above, starred: true is an Action line) or a URL then it is read into the description. So the following example will result in exactly the same link being sent with all the same attributes:

Subject: Hacktivist deletes white supremacist websites live onstage during hacker conference

So cool! Hackers deleted a white supremacist website during a live demo at a
starred: true
hacker conference.
tags: hacker, conference, live on stage, cool
https://techcrunch.com/2026/01/05/hacktivist-deletes-white-supremacist-websites-live-on-stage-during-hacker-conference/

A clean, and more organized way, would be the following (again, it will produce the exact same end result as the two examples above):

Subject: Hacktivist deletes white supremacist websites live onstage during hacker conference

https://techcrunch.com/2026/01/05/hacktivist-deletes-white-supremacist-websites-live-on-stage-during-hacker-conference/

So cool! Hackers deleted a white supremacist website during a live demo at a
hacker conference.

tags: hacker, conference, live on stage, cool
starred: true

This uses a single blank line to separate the URL line, the description lines, and finally the action lines.

#The three line types

So let's talk about the different line types. It's very simple actually but just to be very clear.

  • URL line - this is simply a URL on a single line. It should be the only thing placed on this line. No text before or after it. Just the URL you want to save.
  • Action line - this is a special line used to set attributes when saving the link. Here are the optional action lines:
    • tags: - This is the comma separated list of tags you wish to use. There is a maximum of 10 tags at the moment.
    • unread: boolean (true/false). This will mark the link as unread (or not). Defaults to false.
    • public: boolean (true/false). This will mark if the bookmark is publicly visible on the organizations profile. Defaults to true.
    • org: This is the slug of the organization you want to save this link to. It should be an organization that is paid and that you have write access to. Defaults to your personal organization created when you signed up.
    • starred: boolean (true/false). This will mark the link as starred (or not). Default is false.
    • archive: boolean (true/false). This will flag if the link should be archived using the way back machine. Default to false.
  • Description lines - these are any lines that are not one of the two other line types above. All lines will be appended into a single description for the saved bookmark.

You can use a few options to specify boolean (true/false) values as well.

  • True: true, yes, 1
  • False: false, no, 0. Technically it doesn't matter. If the value is anything but a "true" value specified above, it's left to a false value.

That's it. Pretty simple right?

#Success and errors

Regardless if the link is successfully saved or not, you will not receive an email reply stating the result. This is due to avoid potential spam traps. If you're unsure of why an email is not working to save to your organization, please forward the email to hello@linktaco.com and explain the situation. We will review the email and the logs to see if we can find the issue.

Of course if it was successful you will be able to see the link when you visit your LinkTaco account.

About this wiki

commit bd9fe0a1ab7be32da07f40a559f0f13581dc6974
Author: Peter Sanchez <peter@netlandish.com>
Date:   2026-01-07T16:36:46-06:00

Adding post via email docs
Clone this wiki ("master" branch)
https://git.code.netlandish.com/~netlandish/links-wiki (read-only)
git@git.code.netlandish.com:~netlandish/links-wiki (read/write)