Integration
Connect Letterhead and Loop Returns
When Audience Member Created or Updated fires in Letterhead, your agent runs Create Allowlist Item in Loop Returns, or New Return Created in Loop Returns to Add Contact to Tag in Letterhead. Describe the whole flow and it is built, tested on every scenario and kept running.
What the catalog holds today. Ask for anything missing and your agent reads the API documentation and adds it.
Build solutions, not workarounds.
What do you want Letterhead and Loop Returns to do together?
Ask the assistant
Connect your AI client
Give your AI client this address.
https://mcp.apiant.aiOne 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.aiStart Claude Code there, approve the server, and sign in in the browser page it opens.
Claude Code guide (opens in a new tab)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)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)Zed
Open Settings, then AI, then MCP Servers, then Add Server, then Add Remote Server.
Setup guide (opens in a new tab)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)Grok
Open grok.com/connectors, choose New Connector, then Custom, and paste the address. Grok signs you in in your browser.
Setup guide (opens in a new tab)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)Example flows
What Letterhead and Loop Returns can do together
From Letterhead to Loop Returns
When Audience Member Created or Updated in Letterhead
then Create Allowlist Item in Loop Returns
When Promotion Campaign Created in Letterhead
then Create Blocklist Item in Loop Returns
From Loop Returns to Letterhead
When New Return Created in Loop Returns
then Add Contact to Tag in Letterhead
When Return Status Updated in Loop Returns
then Add or Update Contact in Letterhead
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 Letterhead and Loop Returns
Triggers and actions 8 triggers · 125 actions
Trigger
Audience Member Created or UpdatedTriggers when a contact is added to your Letterhead audience or their details change.
Trigger
Newsletter PublishedTriggers when a newsletter is published in any of your Letterhead channels.
Trigger
Newsletter ScheduledTriggers when a newsletter is scheduled in any of your Letterhead channels.
Trigger
Promotion Campaign CreatedTriggers when a new promotion campaign is created in Letterhead.
Trigger
Promotion Campaign PurchasedTriggers when a promotion is purchased from your Letterhead store.
Trigger
Promotion Campaign Status ChangedTriggers when a promotion campaign becomes active or inactive in Letterhead.
Action
Add Contact to TagAdds a Letterhead tag to the contact with the given email.
Action
Add Content to CurationsSaves a web page or post to your Letterhead curations library so you can use it in a newsletter.
Action
Add letterCreates a new company letter template, either blank or seeded from your own HTML.
Action
Add or Update ContactAdds a contact to your Letterhead audience, or updates the existing contact with the same email.
Action
Add promotionCreates a new promotion (ad campaign) in Letterhead that can run on chosen dates or evergreen in your newsletters.
Action
Add tagCreates a new contact tag in your Letterhead audience with a display color.
Action
Delete contactPermanently deletes a contact and all of its subscriptions, tags, custom field values and consent records.
Action
Delete curationDeletes a curated content item from your Letterhead account.
Action
Delete letterPermanently deletes a Letterhead letter or template.
Action
Get letterReturns a single letter, including its title, status, channel and fully rendered email HTML.
Action
Get segmentReturns a single contact segment, including its name, description, matching criteria and the channels it applies to.
Action
List channelsReturns every newsletter channel your Letterhead company owns, with its brand, slug, title and logos.
Action
List custom fieldsReturns your company's contact custom field definitions, with each field's key, label and type.
Action
List lettersReturns letters (newsletters and templates) in your Letterhead company, most recently updated first, optionally filtered by status, keyword, channel or tag.
Action
List promotionsReturns the promotions in your Letterhead account, optionally filtered by keyword, status, channel, promoter or date range.
Action
List segmentsReturns the company's saved contact segments, optionally narrowed to one channel.
Action
List tagsReturns your company's contact tags, each with its audience member count, optionally filtered by name.
Action
Remove Contact From TagRemoves a Letterhead tag from the contact with the given email.
Action
Send letterSends a newsletter edition built from your own HTML to a Letterhead channel's subscribers (or one segment of them).
Action
Send transactional emailSends a single transactional email (such as a password reset or receipt) to one recipient through a Letterhead channel.
Action
Update contactUpdates an existing Letterhead contact's name, tags and custom field values, identified by email address.
Action
Update letterReplaces a letter's or template's content and configuration (title, subtitle, blocks, audience segment, status) and returns the updated letter.
Trigger
New Return CreatedTriggers when a new return is created in Loop.
Trigger
Return Status UpdatedTriggers when a Loop return changes state (for example open to closed or cancelled).
Action
Add Product to CollectionAttach a product to a collection.
Action
Add Product to Collection by External IDAttach a product to a collection by commerce `external_id`.
Action
Advanced Shipping NoticeThis endpoint will pull all packages by tracking statuses/timeframe. The ASN endpoint will return an array of
Action
Assess DispositionsAssess return line item dispositions.
Action
Cancel Draft ReturnCancel a draft return.
Action
Cancel ReturnCancel a return in Loop. Canceling a return will allow a customer to make another return with the same
Action
Close ReturnClose a return. Closing a return will not fulfill any outcomes such as exchanges or gift cards, and the
Action
Create Allowlist ItemCreate an allowlist entry.
Action
Create Blocklist ItemCreate a blocklist entry.
Action
Create Bulk OperationUploads a JSONL file of order, product or other jobs and starts a Loop bulk operation that runs them.
Action
Create CartCreate a cart object and populate it with one or more product variants.
Action
Create CollectionCreate a new collection.
Action
Create DestinationCreate a destination.
Action
Create Fraud ReportAttach a fraud report to a return.
Action
Create LocationCreate a new location.
Action
Create ProductCreate a new product.
Action
Create Product VariantCreate a new product variant.
Action
Create Return Deep LinkCreate a deep link URL.
Action
Create Return Deep Link with QR CodeGenerate a link to a QR code image file that,
Action
Create Return NotePost a new note to a return.
Action
Delete Allowlist ItemDelete an allowlist entry.
Action
Delete Blocklist ItemDelete a blocklist entry.
Action
Delete CollectionDelete a collection.
Action
Delete Collection by External IDDelete a collection by its commerce `external_id`.
Action
Delete CustomerDelete a customer.
Action
Delete Customer by External IDDelete a customer by its commerce `external_id`.
Action
Delete DestinationDelete a destination.
Action
Delete InventoryDelete an inventory.
Action
Delete Inventory by External IDsDelete an inventory record identified by the product variant's `external_id` and the location's `external_id`. If more than one product variant in the shop shares the same `external_id`, this request returns `409 Conflict`.
Action
Delete LocationDelete a location.
Action
Delete Location by External IDDelete a location by its commerce `external_id`.
Action
Delete OrderDelete a specific order.
Action
Delete Order by External IDDelete a specific order by its commerce `external_id`.
Action
Delete Product by External IDDelete a product by its commerce `external_id`.
Action
Delete Product from CollectionDelete a product from a collection.
Action
Delete Product from Collection by External IDDelete a product from a collection by commerce `external_id`.
Action
Delete Product VariantDelete a product variant.
Action
Delete Product Variant by External IDDelete a product variant by the parent product's commerce `external_id` and the variant's commerce `external_id`.
Action
Detailed Returns ListPull a detailed list of returns created within a given timeframe.
Action
Finalize ItemsFinalizes the returning items and cart items of the draft return.
Action
Flag ReturnFlag a return in Loop for review. This will prevent automated processing and will require a human to go
Action
Get All DestinationsRetrieve all destinations.
Action
Get Allowlist ItemRetrieve an allowlist entry.
Action
Get Blocklist ItemRetrieve a blocklist entry.
Action
Get Bulk OperationGet the details about a specific bulk operation.
Action
Get CollectionGet details about a single collection.
Action
Get Collection by External IDGet details about a single collection by its commerce `external_id`.
Action
Get CustomerGet details about a single customer.
Action
Get Customer by External IDGet details about a single customer by its commerce `external_id`.
Action
Get Destination DetailsGet details for a single destination.
Action
Get Draft ReturnRetrieves the details of a draft return, including its current state, returning items, cart items, and
Action
Get InventoryGet inventory details for a product variant by location.
Action
Get Inventory by External IDsGet inventory details for a product variant at a location, identified by the variant's `external_id` and the location's `external_id`. If more than one product variant in the shop shares the same `external_id`, this request returns `409 Conflict`.
Action
Get LocationGet the details about a single location.
Action
Get Location by External IDGet the details about a single location by its commerce `external_id`.
Action
Get OrderGet details about a specific order.
Action
Get Order by External IDGet details about a specific order by its commerce `external_id`.
Action
Get ProductGet the details about a single product.
Action
Get Product by External IDGet the details about a single product by its commerce `external_id`.
Action
Get Product VariantGet the details about a single product variant.
Action
Get Product Variant by External IDGet the details about a single product variant by the parent product's commerce `external_id` and the variant's commerce `external_id`.
Action
Get Return DetailsGet the details of a specific return based on a return's ID,
Action
Get Return NotesGet notes on a specific return using the return's ID.
Action
Get Shipment InformationGet high level information from a Happy Returns shipment.
Action
Get Shipment ItemsGet all items for a Happy Returns shipment.
Action
Get ShipmentsGet information about all Happy Returns shipments created within a given timeframe.
Action
Grade ItemsGrade the condition of return line items.
Action
Initialize Draft ReturnInitialize a new draft return.
Action
List Allowlist ItemsRetrieve a list of paginated allowlist entries.
Action
List Blocklist ItemsRetrieve a list of paginated blocklist entries.
Action
List Bulk Operation JobsRetrieve a list of bulk operation jobs.
Action
List Bulk OperationsRetrieve a list of bulk operations. The list can be sorted and paginated using the parameters below.
Action
List CollectionsRetrieve a list of collections. The list can be filtered, sorted, and paginated using the parameters below.
Action
List CustomersRetrieve a list of customers. The list can be filtered, sorted, and paginated using the parameters below.
Action
List InventoriesRetrieve a list of inventories. The list can be filtered, sorted, and paginated using the parameters below.
Action
List LocationsRetrieve a list of locations. The list can be filtered, sorted, and paginated using the parameters below.
Action
List OrdersList all orders.
Action
List ProductsRetrieve a list of products. The list can be filtered, sorted, and paginated using the body parameters below.
Action
List Product VariantsRetrieve a list of product variants. The list can be filtered, sorted, and paginated using the body parameters below.
Action
Look Up Order Return Eligibility by Order NameReport per-line-item return eligibility for an order, by its order name, without starting a return.
Action
Process ReturnProcess a return in Loop based on the return ID. Processing a return will archive it in Loop and
Action
Redact CustomerQueue GDPR customer redaction for a Loop Anywhere (Commerce Data) shop.
Action
Remove Cart ItemRemoves a specific item from the draft return's cart.
Action
Remove Line ItemsRemove one or more line items from an open return.
Action
Remove Returning ItemRemoves a specific item from the draft return's ReturningItems.
Action
Select Return MethodSelects a return method for the draft return.
Action
Set AddressSets the return shipping address for the draft return.
Action
Set Credit TypeSets the credit type for the draft return.
Action
Set CustomerSets the customer information for the draft return.
Action
Set Processing TypeSets the processing type (`regular` or `instant`) of the draft return.
Action
Set Returning Item Return ReasonSets the return reason for a specific returning item.
Action
Set Returning Item Return TypeSets the return type for a specific returning item.
Action
Submit Draft ReturnSubmits the draft return.
Action
Unfinalize ItemsReopens the returning items and cart items of the draft return for modification.
Action
Update CollectionUpdate a collection.
Action
Update CustomerUpdate a customer.
Action
Update DestinationUpdate a destination.
Action
Upsert CollectionUpsert a collection, identified using the collection's `name` and `external_id`.
Action
Upsert CustomerUpsert a customer, identified using the customer's `external_id`.
Action
Upsert InventoryUpsert inventory details for a product variant by location. If the inventory exists, it will be updated; if it doesn't exist, it will be created.
Action
Upsert Inventory by External IDsUpsert inventory details for a product variant at a location, identified by the variant's `external_id` and the location's `external_id`. If the inventory exists, it will be updated; if it doesn't exist, it will be created. The product variant and location must already exist. If more than one produc
Action
Upsert Product VariantUpsert a product variant, identified using the product's `external_id`.
Action
Upsert Product Variant by Product External IDUpsert a product variant under a parent product identified by its commerce `external_id`. The variant is identified using the variant's `external_id` in the request body.
No trigger or action matches that. Ask your agent to add it: it reads the API documentation and builds what you describe.
Each app on its own
Reviews
What our customers say
More from Letterhead
Letterhead to SalesforceSalesforce is a leading enterprise customer relationship management (CRM) platform.
Letterhead to SlackSlack is a messaging platform for teams. Post messages, manage channels, users, reminders, and react to...
Letterhead to MailchimpMailchimp marketing automation and email platform.
Letterhead to StripeStripe is a payment processing platform for online businesses.
Letterhead to ShopifyShopify is a commerce platform for online stores and retail point-of-sale.
Letterhead to QuickBooks OnlineQuickBooks Online accounting — manage customers, invoices, bills, payments, vendors, expenses, and more via...
More into Loop Returns
HubSpot to Loop ReturnsHubSpot is your all-in-one stop for all of your marketing software needs.
Google Sheets to Loop ReturnsGoogle Sheets is Google's online spreadsheet app for creating, editing and sharing spreadsheets.
Gmail to Loop ReturnsGmail is Google’s email service, featuring spam protection, search functions, and seamless integration with...
Google Calendar to Loop ReturnsGoogle Calendar is a time management tool providing scheduling features, event reminders, and integration...
Google Drive to Loop ReturnsGoogle Drive is a cloud storage solution for uploading, sharing, and collaborating on files across devices...
ActiveCampaign to Loop ReturnsActiveCampaign is a marketing automation, email marketing, and CRM platform.
Questions
Letterhead and Loop Returns, answered
What can start an automation from Letterhead?
Any of Letterhead's 6 triggers in the catalog, including Audience Member Created or Updated, Promotion Campaign Created, Promotion Campaign Status Changed and Newsletter Published. Describe the moment in plain language and your agent picks the right one.
What can your agent do in Loop Returns when something happens in Letterhead?
Any of Loop Returns's 103 actions, including Create Allowlist Item, Create Blocklist Item, Create Bulk Operation and Create Cart. Your agent maps the data both ways and tests every scenario before it ships.
Can it also run from Loop Returns to Letterhead?
Yes. When something happens in Loop Returns, your agent can act in Letterhead too. This page covers both directions: Loop Returns's triggers and Letterhead's actions are listed here as well.
Do I have to build a connector for Letterhead or Loop Returns?
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 Letterhead and Loop Returns 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.