# Stannp Stannp provides a direct mail API enabling users to send postcards and letters programmatically. - **Category:** marketing automation - **Auth:** API_KEY - **Composio Managed App Available?** N/A - **Tools:** 32 - **Triggers:** 0 - **Slug:** `STANNP` - **Version:** 20260407_00 ## Tools ### Add recipients to group **Slug:** `STANNP_ADD_RECIPIENTS_TO_GROUP` Tool to add existing recipients to a mailing list group. Use when you need to add recipients from your account to an existing group for campaign management. ### Add Recipient to Group **Slug:** `STANNP_ADD_RECIPIENT_TO_GROUP` Tool to add a recipient to a recipient group. Use when you need to add new mailing list subscribers. ### Cancel Postcard **Slug:** `STANNP_CANCEL_POSTCARD` Tool to cancel a postcard if processing has not started yet. Use when you need to cancel a scheduled postcard before it enters production. ### Create Campaign **Slug:** `STANNP_CREATE_CAMPAIGN` Tool to create a new direct mail campaign on the platform. Use when you need to set up a campaign with recipients and design templates. Requires a valid group_id with recipients. ### Create campaign sample **Slug:** `STANNP_CREATE_CAMPAIGN_SAMPLE` Tool to produce a PDF sample of your campaign. The generated link will be valid for 30 minutes. Use when you need to preview a campaign before sending it to recipients. ### Create folder **Slug:** `STANNP_CREATE_FOLDER` Tool to create a folder in your secure file transfer area. Use when you need to organize files or prepare a storage location before uploading documents. ### Create recipient group **Slug:** `STANNP_CREATE_GROUP` Tool to create a new recipient group in Stannp. Use when you need to organize contacts into a distinct group before sending campaigns. ### Create Letter **Slug:** `STANNP_CREATE_LETTER` Tool to create a letter with mail merge to insert address and variable data. Use when you need to send physical mail via Stannp API. ### Create Postcard **Slug:** `STANNP_CREATE_POSTCARD` Tool to create a postcard. Use when you need to send a postcard via direct mail. ### Create recipient selection **Slug:** `STANNP_CREATE_SELECTION` Tool to create a new recipient selection for targeting in Stannp. Use when you need to create an auto filter selection to target specific recipients within a group based on criteria. ### Delete recipient group **Slug:** `STANNP_DELETE_GROUP` Tool to delete a recipient group in Stannp. Recipients remain on your account unless delete_recipients is true. Use when you need to remove a mailing list group. ### Delete Recipient **Slug:** `STANNP_DELETE_RECIPIENT` Tool to permanently delete a recipient from your account. Use when you need to remove a recipient from your mailing list. ### Get Account Balance **Slug:** `STANNP_GET_ACCOUNT_BALANCE` Tool to retrieve the current account balance. Use when you need to check available account funds. ### Get Campaign **Slug:** `STANNP_GET_CAMPAIGN` Tool to retrieve details of a specific campaign. Use when you need to get information about a campaign by its ID. ### Get Campaign Available Dates **Slug:** `STANNP_GET_CAMPAIGN_AVAILABLE_DATES` Tool to get available dates for scheduling a campaign (up to 30 days). Use when you need to check which dates are available for campaign dispatch. ### Get Campaign Cost **Slug:** `STANNP_GET_CAMPAIGN_COST` Tool to get the estimated cost of booking a campaign. Use when you need to calculate the total cost before booking a direct mail campaign. ### Get Contact **Slug:** `STANNP_GET_CONTACT` Tool to retrieve details of a specific contact. Use when you need all stored fields of a contact by its ID. ### Get Current User **Slug:** `STANNP_GET_CURRENT_USER` Tool to get information about the currently authenticated user including rate limit status. Use when you need to retrieve the current user's account details or check API rate limit status. ### Get Reporting Summary **Slug:** `STANNP_GET_REPORTING_SUMMARY` Tool to get a status summary on individual items within a date range. Use when you need reporting metrics for mailpieces including delivery status, printing status, and counts. ### Import Recipients **Slug:** `STANNP_IMPORT_RECIPIENTS` Tool to import recipients from a CSV or XLS file into a Stannp recipient group. Use when you have a mailing list file ready to upload. ### List Campaigns **Slug:** `STANNP_LIST_CAMPAIGNS` Tool to get a list of all campaigns. Use when you need to retrieve campaigns after authentication. ### List Contacts **Slug:** `STANNP_LIST_CONTACTS` Tool to list all contacts. Use when you need to retrieve contacts with optional pagination filters. ### List Folders **Slug:** `STANNP_LIST_FOLDERS` Tool to get a list of folders in your secure file transfer area. Use when you need to retrieve available folders for file organization. ### List Mailing Groups **Slug:** `STANNP_LIST_GROUPS` Tool to get a list of mailing groups on your account. Use when you need to retrieve all groups with optional pagination. ### List Mailpieces **Slug:** `STANNP_LIST_MAILPIECES` Tool to retrieve mailpiece objects sent within a date range. Use when you need to query mailing history with optional status or tag filters. ### List Templates **Slug:** `STANNP_LIST_TEMPLATES` Tool to list all templates associated with the account. Use when you need to retrieve available templates after authentication. ### Merge PDF files **Slug:** `STANNP_MERGE_PDFS` Tool to merge multiple PDF files into a single file. Use when you need to consolidate multiple PDFs into one document. ### Purge Group **Slug:** `STANNP_PURGE_GROUP` Tool to remove all recipients from a mailing list. Recipients remain on your account if delete_recipients is false. ### Recalculate group **Slug:** `STANNP_RECALCULATE_GROUP` Tool to recalculate a group to ensure stats are up to date. Use when you need to refresh group statistics after adding or removing recipients. ### Remove Recipients from Group **Slug:** `STANNP_REMOVE_RECIPIENTS_FROM_GROUP` Tool to remove recipients from a group without deleting them. Use when you need to remove contacts from a mailing group while keeping them in your account. ### Upload File **Slug:** `STANNP_UPLOAD_FILE` Tool to upload a file to your secure file transfer area. Use when you need to upload files for direct mail campaigns. Supports both URL-based imports and binary file uploads. ### Validate Address **Slug:** `STANNP_VALIDATE_ADDRESS` Tool to validate a postal address. Currently supports UK and US addresses only. Use when you need to verify if a given address is valid before sending mail.