Introducing Email to Tarkle

Santhia Roo3 min readPublished


Clients send files by email. A link, a portal or a shared folder asks them to learn something new first, so many of them reply with an attachment anyway, and someone on your side downloads it, renames it and files it by hand.

Today we're introducing Email to Tarkle. Every workspace now has its own email address, and files attached to an email sent there are saved in the workspace. The sender doesn't sign in or install anything. It's available on every plan, Free included.

How Email to Tarkle works

Each workspace gets an address like this:

workspace-name.random-code@inbox.tarkle.tech

Say a client emails a signed contract to that address. Three things happen:

  • The PDF is saved in a new folder named with the sender, the date and the subject, inside the locked Email inbox folder.

  • The client is added to People, and the file shows "Via Email" so you can tell where it came from.

  • The client gets a short reply that lists what was saved. If a file wasn't saved, the reply says why in plain words, so nobody wonders whether it arrived.

Owners, admins and members can open the Email inbox folder. Viewers can't.

Turn it on

Open Settings and find the Email to Tarkle card. Workspace owners and admins can turn it on, copy the address and send it to a client. The random code keeps the address private, so share it with the people you want sending files.

Decide who can send

By default anyone with the address can send. In the same card, you can limit it to workspace members or to the owner only.

If the address ends up where it shouldn't, make a new one. The old address stops working at once. Turn the feature off and every email is refused. The reply to the sender is on by default, and you can switch it off.

What one email can carry

An email can carry up to 100 attachments and 25 MB together. Program files such as .exe and .bat are refused. Small signature images are skipped, so a logo in an email footer doesn't become a file. Spam and out-of-office replies save nothing.

Plans

The workspace address is on every plan. Pro and Agency add two more:

  • A private address for each member, which saves into a private folder called My email inbox on the Account page.

  • An address on your own domain, for example files@inbox.acme.com.

Build on it

The same settings are in the API. An owner or admin token with the email_inbox:write scope can turn the address on and limit who can send:

curl -X PATCH https://tarkle.com/api/v1/email-inbox \

-H "Authorization: Bearer $TARKLE_TOKEN" \

-H "X-Workspace-Key: $KEY" \

-H "Content-Type: application/json" \

-d '{"enabled": true, "sender_policy": "members"}'

The answer shows the new state: enabled, address, custom_address, sender_policy, send_confirmation and personal_inboxes. Send "regenerate": true to replace the address. sender_policy is anyone, members or only_me.

To see what came in, call GET /api/v1/email-inbox/received with the email_inbox:read scope. It lists the emails that brought files in, newest first, with the sender, the subject, the folder and every file. Filter by inbox, sender, days (default 30) and limit, or add include_not_saved=true to see the emails that saved nothing and why.

Try it

Open Settings, find Email to Tarkle and send yourself a file. New to Tarkle? Start on the Free plan. Plans are on the pricing page.