Skip to content
Changelog

Report a bug

Thanks.io integration: operations for AI agents

Thanks.io connects to Type.com as an integration. This page lists the 52 operations documented for Claude and Codex in Type.com: 19 read, 22 write, 11 destructive.

About Thanks.io

thanks.io is a direct mail automation platform that enables users to send personalized postcards, letters, and notecards with handwritten fonts.

Categories: Marketing & Social

How to connect Thanks.io to Type.com

Access
Organization connection: one shared account for the workspace.

To add the connection, follow the steps in Space connections.

Documented operations

52 operations. Your connection's permissions determine which operations are available. API references describe the vendor surface; they do not expand your connection's credentials or access.

52 operations listed.

Recipients

  • Read

    Get Recipient

    Get a recipient by ID.

  • Write

    Create Recipient

    Add a recipient. If you do not provide a valid mailing address but do provide a valid email address, thanks.io can attempt to look up a street address for an additional fee.

  • Write

    Create Multiple Recipients

    Add multiple recipients at once using a JSON array of recipient objects. If a recipient does not include a valid mailing address but does include a valid email address, thanks.io can attempt to look up a street address for an additional fee.

  • Destructive

    Update Recipient

    Update details of a specific recipient by ID. Leave out absenteeaddress to keep the current absentee address.

  • Destructive

    Delete Recipient

    DELETE /recipients/{recipientId}

  • Destructive

    Delete Recipient By Address

    Delete a recipient by using their address or their email address.

Mailing Lists

  • Read

    List All

    List all available mailing lists. Returns a paginated list of mailing lists.

  • Read

    Get Details

    Gets a mailing list by ID. Returns a single mailing list object.

  • Read

    List Recipients

    Retrieve recipients for a specific mailing list.

  • Write

    Create Mailing List

    If qrcodeurl is provided, it will be used as the default QR Code URL when placing orders with this mailing list.

  • Destructive

    Delete Mailing List

    DELETE /mailing-lists/{mailingListId}

Send Mailer

  • Write

    Send Postcard

    Send a 4x6, 6x9, or 6x11 postcard.

  • Write

    Send Magnacard

    Send a Magnacard.

  • Write

    Send Windowed Letter

    Send a letter in a windowed envelope.

  • Write

    Send Windowless Letter

    Send a letter in a windowless envelope.

  • Write

    Send Notecard

    Send a folded 4.25x5.5 notecard in envelope.

  • Write

    Send Giftcard

    Send a folded 4.25x5.5 giftcard in envelope.

Order Estimates

  • Write

    Estimate Postcard

    Price a postcard order without placing it. Send the same request body you would send to Send Postcard: nothing is charged, nothing is printed or mailed, and no order is created.

  • Write

    Estimate Windowed Letter

    Price a windowed letter order without placing it. Send the same request body you would send to Send Windowed Letter: nothing is charged, nothing is printed or mailed, and no order is created.

  • Write

    Estimate Windowless Letter

    Price a windowless letter order without placing it. Send the same request body you would send to Send Windowless Letter: nothing is charged, nothing is printed or mailed, and no order is created.

  • Write

    Estimate Notecard

    Price a notecard order without placing it. Send the same request body you would send to Send Notecard: nothing is charged, nothing is printed or mailed, and no order is created.

  • Write

    Estimate Magnacard

    Price a magnacard order without placing it. Send the same request body you would send to Send Magnacard: nothing is charged, nothing is printed or mailed, and no order is created.

  • Write

    Estimate Giftcard

    Price a giftcard order without placing it. Send the same request body you would send to Send Giftcard: nothing is charged, nothing is printed or mailed, and no order is created.

Dynamic Images

  • Read

    Create

    Build image for the front of your postcard or notecard. Includes ability to set dynmiac fields and QR code. This does not create an order, it simply builds the image and returns a URL to the image. You can then use this image URL in your order creation request.

Handwriting Styles

  • Read

    List Styles

    List Available Handwriting Styles

Giftcards

  • Read

    List Brands

    List all available Giftcard brands.

  • Read

    List Brands Flat

    List all available Giftcard brands as a flat list.

Sub Accounts

  • Read

    List All

    List all available sub-accounts.

  • Read

    Get Details

    Gets a sub-account by ID. Returns a single sub-account object. brandingfields is an object that contains branding information for the sub-account - it can only be set via the thanks.io dashboard

  • Write

    Create Sub Account

    Create a new sub-account.

  • Destructive

    Update Sub Account

    PUT /sub-accounts/{subAccountId}

  • Destructive

    Delete Sub Account. All sub account orders and mailing lists are moved to the main account.

    Delete Sub Account. All sub account orders and mailing lists are moved to the main account. All image templates, message templates, and campaigns are deleted.

Image Templates

  • Read

    List All

    List all available image templates.

Creatives Library

  • Read

    List All

    List the creatives in your Creatives library, 24 per page: the default creative of each type first, then most recently updated. A creative pairs an image template with a message template; send one by passing its id as creativeid to any send or estimate endpoint.

  • Read

    Get

    Get one creative from your Creatives library, with the image and message templates it pairs.

Message Templates

  • Read

    List All

    List all available message templates.

  • Read

    Get Message Template

    Fetch a single message template by ID.

  • Write

    Create Message Template

    Create a message template for the authenticated user using the public v2 request shape.

  • Write

    Update Message Template

    Update a message template using the public v2 request shape.

  • Destructive

    Delete Message Template

    Delete a message template.

Webhooks

  • Read

    List Webhooks

    Return a paginated list of configured webhooks. Webhooks are available on paid subscriptions only.

  • Write

    Create Webhook

    Create a webhook destination. Webhooks are available on paid subscriptions only.

  • Destructive

    Update Webhook

    Update an existing webhook destination. Webhooks are available on paid subscriptions only.

  • Destructive

    Delete Webhook

    Delete a webhook destination. Webhooks are available on paid subscriptions only.

Orders

  • Read

    List Orders

    Return list of recent orders.

  • Read

    Track Order

    Return Summary of delivery status for the order.

  • Read

    List Order Items

    Return the individual mail pieces that make up an order, one entry per recipient, with that piece's delivery status, delivery date, QR scan count, failure reason and recipient address.

  • Write

    Replay Order

    Submit a copy of a previously placed order as a brand-new order. The same creative is charged and mailed again, and the original order is left untouched. By default the replay is sent to the recipients the original actually reached (failed items are excluded).

  • Destructive

    Cancel Order

    If Order is in Reviewing Status, then this will cancel the order and refund the credits for the order back to your account. If the order can be successfully canceled, the status will be updated to cancelled.

  • Destructive

    Invalidate Gift Card

    Invalidate the gift card on a mailed piece so it can no longer be redeemed, for example when a card was sent by mistake. This does the same as the Invalidate button on the Order Details page, and it can't be undone. PATCH is accepted as well as PUT.

See How connections work for access and permissions, or browse all integrations.