---
title: "Connect Uploadcare and thanks.io - APIANT.ai"
description: "When \"New File Uploaded\" fires in Uploadcare, your agent runs \"Lookup Address by Email\" in thanks.io."
canonical: "https://apiant.ai/connect/uploadcare-to-thanks-io"
---

# Connect Uploadcare and thanks.io

When **New File Uploaded** fires in [Uploadcare](https://apiant.ai/connections/uploadcare), your agent runs **Lookup Address by Email** in [thanks.io](https://apiant.ai/connections/thanks-io), or **New Order** in thanks.io to **Find files** in Uploadcare. Describe the whole flow and it is built, tested on every scenario and kept running.

Uploadcare **1** trigger Uploadcare **15** actions thanks.io **3** triggers thanks.io **3** actions

What the catalog holds today. Ask for anything missing and your agent reads the API documentation and adds it.

## What do you want Uploadcare and thanks.io to do together?

Give your AI client this address.

`https://mcp.apiant.ai`

One connection does both: ask your client to act in an app once, or have it build an automation that keeps running. Any client that takes a remote MCP server. Nothing to install. Create your free account, then sign in once in your browser.

### Set it up in your client

### Claude Code

Run this in the directory you want to work in.

`claude mcp add --transport http -s project apiant-ai https://mcp.apiant.ai`

Start Claude Code there, approve the server, and sign in in the browser page it opens.

[Claude Code guide (opens in a new tab)](https://apiant.ai/docs/mcp/claude-code)

### Claude, web and desktop

Open Customize, then Connectors, then Add custom connector, and paste the address. On Team and Enterprise an owner adds it first.

[Setup guide (opens in a new tab)](https://apiant.ai/docs/mcp)

### Cursor

Add the address to your MCP configuration as a server URL. Cursor signs you in in your browser.

[Setup guide (opens in a new tab)](https://apiant.ai/docs/mcp)

### Zed

Open Settings, then AI, then MCP Servers, then Add Server, then Add Remote Server.

[Setup guide (opens in a new tab)](https://apiant.ai/docs/mcp)

### Codex and the ChatGPT desktop app

Open Settings, then MCP servers, then Add server, and choose Streamable HTTP. From the terminal, Codex takes the address with its own add command and then signs you in.

[Setup guide (opens in a new tab)](https://apiant.ai/docs/mcp)

### Any other MCP client

Paste the address where the client asks for a remote MCP server URL, and name the server apiant-ai where it lets you. APIANT's skills reach the client over the same connection.

[Setup guide (opens in a new tab)](https://apiant.ai/docs/mcp)

Uploadcare holds the artwork, proofs and scans your customers send in, while thanks.io mails the postcards, letters and giftcards. Connecting them lets an upload in Uploadcare create or check a recipient in thanks.io, and lets mail events in thanks.io tag, store or annotate the matching file so the record of each send stays with the artwork.

Example flows

## What Uploadcare and thanks.io can do together

### From Uploadcare to thanks.io

- When **New File Uploaded** in Uploadcare then **Lookup Address by Email** in thanks.io
- When **New File Uploaded** in Uploadcare then **Add Recipient** in thanks.io

### From thanks.io to Uploadcare

- When **New Order** in thanks.io then **Find files** in Uploadcare
- When **QR Code Scan** in thanks.io then **Get file** in Uploadcare

Starting points drawn from the triggers and actions in the catalog today. Describe the flow you need, at any depth, and your agent builds it and tests every scenario before it ships.

Everything your agent can do with Uploadcare and thanks.io

## Triggers and actions 4 triggers · 18 actions

- Trigger

**New File Uploaded**

Triggers when a new file is uploaded.

- Action

**Add file tags**

/files/{uuid}/tags/ (add mode) — add tags to a file for organization/AI auto-tagging.

- Action

**Add group**

/groups/ (Upload API) — create a file group from a set of uploaded file UUIDs.

- Action

**Convert document**

convert a document/image to another format (e.g. PDF, DOCX to images).

- Action

**Convert video**

transcode/thumbnail a video file into another format.

- Action

**Delete file**

delete a file.

- Action

**Delete group**

delete a file group (does not delete member files).

- Action

**Find files**

/files/ with query params — search/filter uploaded files by criteria (used with removed/stored/uploaded_range filters).

- Action

**Get file**

file info: metadata, size, mime type, URLs.

- Action

**Get file metadata**

arbitrary key-value metadata attached to a file.

- Action

**Get group**

file group info: files list, creation date, storage flag.

- Action

**List files**

return paginated list of uploaded files, with filters (stored, removed, ordering).

- Action

**List groups**

paginated list of file groups.

- Action

**Store file**

mark an uploaded file as permanently stored.

- Action

**Update file metadata**

set/update a metadata key's value on a file.

- Action

**Upload File**

Upload a new file into your project.

- Trigger

**Item Delivered**

Triggers when a postcard, letter, notecard, or giftcard is delivered to a recipient.

- Trigger

**New Order**

Fires once for each new order placed in your thanks.io account.

- Trigger

**QR Code Scan**

Triggers when a QR Code on a postcard, letter, or notecard is scanned. This will also trigger when a giftcard is redeemed.

- Action

**Add Recipient**

Adds a recipient to your account and to an optional list. Only US or Canadian addresses are accepted. If no/invalid address is specified and a valid email address is, we'll attempt to look up a valid street address using the email address for a fee.

- Action

**Delete Recipient**

Deletes a Recipient from Mailing List.

- Action

**Lookup Address by Email**

Returns the mailing address on file for a recipient in a thanks.io mailing list, looked up by their email address. Returns an empty list of matches when no recipient in that list has the email.

## Each app on its own

- [ **Uploadcare** File system as a service to handle your web and mobile app uploads.](https://apiant.ai/connections/uploadcare)
- [ **thanks.io** Thanks.io is a way to automatically send ‘handwritten’ postcards, letters, notecards, and giftcards at scale...](https://apiant.ai/connections/thanks-io)

Reviews

## What our customers say

## More from Uploadcare

- [ **Uploadcare to ImprovMX** API for free email forwarding service](https://apiant.ai/connect/uploadcare-to-improvmx)
- [ **Uploadcare to Zoom** Zoom unifies cloud video conferencing, simple online meetings, group messaging, and a software-based...](https://apiant.ai/connect/uploadcare-to-zoom)
- [ **Uploadcare to Webflow** Webflow is a professional website builder and CMS for designing, building, and launching responsive...](https://apiant.ai/connect/uploadcare-to-webflow)
- [ **Uploadcare to Wix** The Wix website builder gives businesses of any size the tools to create, manage and grow a fully integrated...](https://apiant.ai/connect/uploadcare-to-wix)
- [ **Uploadcare to LinkedIn** LinkedIn is a professional networking platform enabling job seekers, companies, and thought leaders to...](https://apiant.ai/connect/uploadcare-to-linkedin)
- [ **Uploadcare to Facebook** Facebook is a social media and advertising platform used by individuals and businesses to connect, share...](https://apiant.ai/connect/uploadcare-to-facebook)

## More into thanks.io

- [ **Goaffpro to thanks.io** Affiliate marketing platform for ecommerce stores, managing affiliate recruiting, commissions, and referral...](https://apiant.ai/connect/goaffpro-to-thanks-io)
- [ **HubSpot to thanks.io** HubSpot is your all-in-one stop for all of your marketing software needs.](https://apiant.ai/connect/hubspot-to-thanks-io)
- [ **Salesforce to thanks.io** Salesforce is a leading enterprise customer relationship management (CRM) platform.](https://apiant.ai/connect/salesforce-to-thanks-io)
- [ **Slack to thanks.io** Slack is a messaging platform for teams. Post messages, manage channels, users, reminders, and react to...](https://apiant.ai/connect/slack-to-thanks-io)
- [ **Google Sheets to thanks.io** Google Sheets](https://apiant.ai/connect/google-sheets-to-thanks-io)
- [ **Gmail to thanks.io** Gmail is Google’s email service, featuring spam protection, search functions, and seamless integration with...](https://apiant.ai/connect/gmail-to-thanks-io)

Questions

## Uploadcare and thanks.io, answered

###

### Can a file uploaded to Uploadcare become a mailing recipient in thanks.io?

Yes. The New File Uploaded trigger in Uploadcare can feed the Add Recipient action in thanks.io, with the name, address and optional list taken from what came in with the upload. Only US or Canadian addresses are accepted by thanks.io.

###

### How do I record in Uploadcare that a piece of mail arrived or was scanned?

The Item Delivered and QR Code Scan triggers in thanks.io can run Add file tags or Update file metadata on the related file in Uploadcare. The agent tests every scenario, including an upload with no matching recipient, before the work goes live.

###

### What can start an automation from Uploadcare?

Any of Uploadcare's 1 trigger in the catalog, including New File Uploaded. Describe the moment in plain language and your agent picks the right one.

###

### What can your agent do in thanks.io when something happens in Uploadcare?

Any of thanks.io's 3 actions, including Add Recipient, Delete Recipient and Lookup Address by Email. Your agent maps the data both ways and tests every scenario before it ships.

###

### Can it also run from thanks.io to Uploadcare?

Yes. When something happens in thanks.io, your agent can act in Uploadcare too. This page covers both directions: thanks.io's triggers and Uploadcare's actions are listed here as well.

###

### Do I have to build a connector for Uploadcare or thanks.io?

No. Both are in the catalog with their triggers and actions. You describe the automation; your agent builds it, tests every scenario and keeps it running.

###

### Can my AI client use Uploadcare and thanks.io without building an automation?

Yes. With your AI client connected to APIANT, ask it to do something in either app once and it runs that action on the spot. Ask for an automation and your agent builds it, tests every scenario and keeps it running. One connection covers both.

###

### What happens when something fails?

Your agent works that out for you. It plans the failure paths along with the happy path, then tests every scenario before it ships.

###

### Is there a free plan?

Yes. Every plan includes the agent, including free, and building from your own AI client spends no assistant credits.
