Stannp provides a direct mail API enabling users to send postcards and letters programmatically.
Toolkit · stannp
v1
01Add Recipient to Grouptool
02Add recipients to grouptool
03Cancel Postcardtool
04Create Campaigntool
API Key · verified
32T · 0TR
stannp
Supported tools and triggers
Each tool is a typed function your agent can call. Each trigger fires an agent run when something changes upstream.
Add Recipient to Group
Tool to add a recipient to a recipient group. Use when you need to add new mailing list subscribers.
TOOL
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.
TOOL
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.
TOOL
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.
TOOL
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.
TOOL
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.
TOOL
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.
TOOL
Create Postcard
Tool to create a postcard. Use when you need to send a postcard via direct mail.
TOOL
Create recipient group
Tool to create a new recipient group in Stannp. Use when you need to organize contacts into a distinct group before sending campaigns.
TOOL
Create recipient 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.
TOOL
Delete Recipient
Tool to permanently delete a recipient from your account. Use when you need to remove a recipient from your mailing list.
TOOL
Delete recipient 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.
TOOL
Get Account Balance
Tool to retrieve the current account balance. Use when you need to check available account funds.
TOOL
Get Campaign
Tool to retrieve details of a specific campaign. Use when you need to get information about a campaign by its ID.
TOOL
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.
TOOL
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.
TOOL
Get Contact
Tool to retrieve details of a specific contact. Use when you need all stored fields of a contact by its ID.
TOOL
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.
TOOL
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.
TOOL
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.
TOOL
List Campaigns
Tool to get a list of all campaigns. Use when you need to retrieve campaigns after authentication.
TOOL
List Contacts
Tool to list all contacts. Use when you need to retrieve contacts with optional pagination filters.
TOOL
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.
TOOL
List Mailing Groups
Tool to get a list of mailing groups on your account. Use when you need to retrieve all groups with optional pagination.
TOOL
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.
TOOL
List Templates
Tool to list all templates associated with the account. Use when you need to retrieve available templates after authentication.
TOOL
Merge PDF files
Tool to merge multiple PDF files into a single file. Use when you need to consolidate multiple PDFs into one document.
TOOL
Purge Group
Tool to remove all recipients from a mailing list. Recipients remain on your account if delete_recipients is false.
TOOL
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.
TOOL
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.
TOOL
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.
TOOL
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.