manage_basket
Manage Basket
Add orders to the basket for batch processing, view the current basket, send all basket orders, or clear the basket. Use this when sending multiple cards at once — add each card to the basket, then send all at once.
Supported Tools
list_gift_cards
List Gift Cards
Retrieve available gift cards that can be included with handwritten card orders. Returns brands (e.g., Starbucks, Amazon) and their available denominations. Use the denomination ID when sending a card with a gift card.
browse_cards
Browse Cards
Browse available card and stationery designs. Filter by category or paginate through results. Returns card IDs needed for sending cards. Use this to find the right card design before sending.
list_inserts
List Inserts
Retrieve available physical inserts (e.g., business cards, magnets) that can be included with card orders. Use the insert ID when sending a card to include a physical insert.
list_orders
List Orders
Retrieve a list of past and current orders with their status. Each order includes details about the message, recipient, sender, card, and current processing status (processing, written, complete, problem, or cancelled).
list_return_addresses
List Return Addresses
Retrieve all saved return (sender) addresses on the account. Use the address ID as returnAddressId when adding orders to the basket.
send_card
Send Card
Send a physical handwritten card or note to a recipient. Provide the message, card design, handwriting style, recipient address, and optional sender address. Cards can be scheduled for future delivery by specifying a send date. You can also include a gift card or physical insert with the order.
manage_templates
Manage Templates
Create, update, delete, or list message templates. Templates store reusable message content for common outreach scenarios such as thank-you notes, birthday cards, etc.
get_card_details
Get Card Details
Retrieve detailed information about a specific card design including images (front, inside, envelope, back), pricing, dimensions, character limits, and custom card info.
list_card_categories
List Card Categories
Retrieve all available card categories. Use the returned category IDs to filter cards when browsing card designs.
manage_address_book
Manage Address Book
Create, update, delete, search, or list recipient contacts in the Handwrytten address book. Set the **action** field to choose the operation. When searching, provide a query to match against name, address, or other fields.
list_handwriting_styles
List Handwriting Styles
Retrieve all available handwriting styles (fonts). Each style uses a different handwriting appearance written by robotic pens. Use the returned font label when sending cards.
More integrations teams use with Handwrytten
Slack
Slack: connect with bot OAuth or user OAuth. Send, update, delete, and schedule messages; list and cancel scheduled messages; open DMs and group DMs; manage conversations, members, files, reactions, pins, bookmarks, reminders, user groups, and user status; search messages and files with user scopes; and retrieve user, conversation, and workspace info.
Sharepoint
Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Subscribe to webhooks for list and library change notifications. Retrieve site properties and search for sites across Microsoft 365.
Hubspot
Create, read, update, and delete CRM objects including contacts, companies, deals, tickets, and custom objects. Manage associations between CRM records. Track engagements such as calls, emails, meetings, notes, and tasks. Send transactional and marketing emails, manage campaigns, and handle subscription preferences. Build and manage marketing workflows, sequences, and automation actions. Manage CMS content including blog posts, landing pages, and HubDB tables. Handle commerce data including products, orders, invoices, quotes, and payments. Create and manage contact lists for segmentation. Configure deal, ticket, and order pipelines with custom stages. Search and filter CRM records. Bulk import and export CRM data. Manage users, teams, and account settings. Subscribe to webhooks for real-time notifications on object creation, deletion, property changes, merges, and association changes.
Salesforce
Manage CRM data including Accounts, Contacts, Leads, Opportunities, Cases, and custom objects. Create, read, update, and delete records. Query data using SOQL and search across objects using SOSL. Perform bulk data operations for large-scale imports, exports, and migrations. Execute composite requests to batch multiple operations in a single API call. Access analytics, reports, and dashboards. Manage files and attachments associated with records. Interact with Chatter feeds, posts, and groups for social collaboration. Subscribe to real-time change events via Change Data Capture and Platform Events. Manage org metadata including custom objects, fields, layouts, and workflows. Query data using GraphQL for precise data retrieval across related objects.
Apolloio
Search and prospect B2B contacts and companies from a database of over 275 million people and 70 million organizations. Enrich people and company data with emails, phone numbers, and firmographic details. Create and manage contacts, accounts, deals, and tasks. Add contacts to email sequences and manage sequence statuses. Log and search call records. Perform bulk operations for contact creation, account creation, task creation, and data enrichment.
Microsoft Outlook
Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Subscribe to webhook notifications for changes to messages, calendar events, and contacts. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.
Technical notes for Handwrytten
Send physical handwritten notes and cards using robotic pens. Choose from handwriting styles and 100+ card/stationery designs, or create custom cards with uploaded images and logos. Manage an address book of recipients, create reusable message templates, include gift cards or physical inserts with orders, and schedule cards for future delivery. Support batch ordering via baskets for sending multiple cards at once. Track order status and retrieve proof images of completed letters.
Frequently asked questions
Common questions about connecting Handwrytten to AI agents with Metorial.
Can Metorial connect Handwrytten to AI agents?
Yes. Metorial connects AI agents to Handwrytten through a governed integration layer, so teams can use the provider while keeping access controlled and observable.Does the Handwrytten integration work with MCP?
Metorial is MCP compatible and lets teams expose approved provider tools to MCP-capable agents and clients through a controlled access layer.How does Metorial control access to Handwrytten?
Metorial applies policies across users, groups, providers, agents, and individual tools, then records the context around every agent interaction.Can teams trace Handwrytten activity from agents?
Yes. Metorial records provider activity so teams can inspect tool calls, troubleshoot integrations, and give security teams the visibility they need.