list_contacts
List Contacts
List and search contacts in PostGrid. Supports pagination and text search to find specific contacts.
list_contacts
List and search contacts in PostGrid. Supports pagination and text search to find specific contacts.
cancel_order
Cancel a PostGrid mail order that has not yet been printed. Only orders with status "ready" can be cancelled. Supports letters, postcards, cheques, and self-mailers.
verify_international_address
Verify and standardize an international postal address across 245+ countries using PostGrid. Accepts either a freeform address string or structured address fields.
autocomplete_address
Get type-ahead address suggestions for US and Canadian addresses. Provide a partial street address and receive matching completions. No lookup is consumed for preview suggestions.
send_self_mailer
Send a physical self-mailer (folded mail without an envelope) through PostGrid. Provide content as template IDs, HTML, or a PDF URL.
verify_address
Verify and standardize a US or Canadian postal address using PostGrid's CASS/SERP-certified database. Accepts either a freeform address string or structured address fields. Returns the standardized address and verification status.
autocomplete_international_address
Get type-ahead address suggestions for international addresses across 245+ countries. Provide a partial street address and optionally filter by country.
get_order
Retrieve the details and current status of a PostGrid mail order. Supports letters, postcards, cheques, and self-mailers. Provide the order ID and the tool will automatically detect the order type from the ID prefix.
send_letter
Send a physical letter through PostGrid. Specify the recipient and sender as contact IDs or inline addresses. Provide content as a template ID, raw HTML, or a PDF URL. Supports options like color printing, double-sided, mailing class, and scheduled send dates.
create_contact
Create a new contact in PostGrid for use as a sender or recipient in mail orders. Contacts store name, company, address, and contact information that can be reused across multiple mailings.
list_templates
List and search PostGrid templates. Returns template IDs and descriptions for use in mail orders.
send_postcard
Send a physical postcard through PostGrid. Provide front and back content as template IDs, HTML, or a 2-page PDF URL. Supports sizes 6x4, 9x6, and 11x6.
send_cheque
Send a physical cheque (check) through PostGrid. Requires a bank account ID, amount in cents, and recipient. Optionally attach an invoice letter using a template, HTML, or PDF.
create_template
Create a reusable HTML template in PostGrid for letters, postcards, or self-mailers. Templates support merge variables using `{{variableName}}` syntax for dynamic personalization.
Send physical mail programmatically including letters, postcards, cheques, and self-mailers. Manage contacts and reusable templates with merge variables for personalized mailings. Verify, standardize, and autocomplete postal addresses across the US, Canada, and 245+ countries. Track mail order status through printing, delivery, and completion stages. Run bulk mail campaigns to contact lists. Process PDFs with OCR address extraction and HTML-to-PDF rendering. Add QR codes and personalized URLs to track mailpiece engagement. Manage return envelopes and detect recipient address changes via NCOA. Receive webhook notifications for mail order lifecycle events.
Common questions about connecting Postgrid to AI agents with Metorial.