otherapi_key

Postalytics

Direct Mail Automation software in the cloud with deep integration to CRM and workflows, making direct mail look, act and feel like a digital marketing channel

Verdict

Postalytics sends physical direct mail — postcards, letters, and self-mailers — from inside Switchy. @mention it to create campaigns, add recipients to contact lists, build templates with HTML or image URLs, and track delivery events via webhooks. Marketing teams running ABM plays or customer success teams sending handwritten-style notes get the most use. The MCP exposes 24 tools covering campaign setup, contact management, suppression lists, and account provisioning. You'll need an API key from your Postalytics dashboard. Templates must be created and proofed before launching a campaign, so expect a two-step workflow for new sends.

Common use cases

  • Send ABM postcards to target accounts
  • Mail handwritten thank-you notes after demos
  • Trigger re-engagement letters for churned users
  • Suppress opted-out contacts across campaigns
  • Track delivery events via webhook notifications

Integration

Vendor
Postalytics
Category
other
Auth
API_KEY
Tools
24
Composio slug
postalytics

Tools

  • Add Account

    Tool to create a new sub-account in the Postalytics system. Use when you need to create a new account with a unique ID associated with the requester's user ID as parent. The response includes the API key and user ID for the new account, whi

  • Add Contact

    Tool to add a contact to a specified contact list with their information. Use when you need to create a new contact or update an existing one on a contact list.

  • Create New Campaign

    Tool to create a new direct mail campaign in Postalytics. Use when you need to start a new campaign with specified sender details and template. Important: A template must be created and proofed before creating the campaign.

  • Create Suppression List

    Tool to create a new suppression list that can be used in campaigns to suppress contacts from being sent mail. Use when you need to create an empty suppression list. Note that contacts must be added separately using the SuppressionListConta

  • Create Suppression List Contact

    Tool to create a new suppression contact on a specified suppression list. Use when you need to add a contact to a suppression list to prevent them from receiving mailings.

  • Create Template

    Tool to create a new template with full HTML for postcard or letter. Use when you need to create a template by providing complete HTML markup or image URLs for front/back. The template can be used for various mail types including postcards,

  • Create Webhook

    Tool to create a new webhook to receive campaign event notifications from Postalytics. Use when you need to set up a webhook endpoint that will be notified about campaign events like sent, delivered, opened, or clicked.

  • Delete Account
    destructive

    Tool to delete a Postalytics account and all associated campaigns, templates, and lists. Use when you need to permanently remove a sub account or sub user account. Cannot delete parent accounts.

  • Delete Campaign
    destructive

    Tool to delete a campaign from the system. Use when you need to remove a campaign that is no longer needed.

  • Delete Suppression List
    destructive

    Tool to delete a specified suppression list. Use when you need to remove a suppression list that is no longer needed.

  • Delete Suppression List Contact
    destructive

    Tool to delete a specific contact from a suppression list. Use when you need to remove a contact from a suppression list in Postalytics.

  • Get All Contact Lists

    Tool to retrieve all contact lists for an account. Use when you need to get a complete list of contact lists including their IDs, names, item counts, and creation dates.

  • Get All Contacts on a List

    Tool to retrieve all contacts from a specified contact list with pagination support. Use when you need to get contacts from a list, with optional pagination using start offset and limit parameters.

  • Get All Drip Campaigns

    Tool to retrieve all triggered drip campaign names and endpoint IDs in the account. Use when you need to list all available drip campaigns for the authenticated user.

  • Get All Flows

    Tool to retrieve all flows for the requester's account. Use when you need to list or browse available flows.

  • Get All Webhooks

    Tool to retrieve all webhooks configured for the authenticated account. Use when you need to view webhook configurations for campaigns.

  • Get Integrations

    Tool to retrieve all Connect integrations configured for the authenticated user's account. Use when you need to view CRM or data source integrations.

  • Get My Account

    Tool to retrieve basic account information for the authenticated user. Use when you need to get account details such as contact information, address, or API key.

  • Get Suppression List

    Tool to get the details of a suppression list based on the id supplied. Use when you need to retrieve information about a specific suppression list.

  • Get Suppression List Contact

    Tool to retrieve a specific contact from a suppression list. Use when you need to get details about a contact on a specific suppression list by their list ID and contact ID.

  • Get Suppression List Contacts

    Tool to get all contacts on a specified suppression list. Use when you need to retrieve contacts that are suppressed for a particular list.

  • Get Suppression Lists

    Tool to retrieve all suppression lists for the authenticated user. Use when you need to view or manage suppression lists. Returns all lists or a specific list when ID is provided.

  • Update Account

    Tool to update an existing account in the Postalytics system. Use when you need to modify account information such as contact details, address, or credentials for an existing account.

  • Update Suppression List Contact

    Tool to update a suppression contact on the specified suppression list. Use when you need to modify contact information for a specific contact on a suppression list.

Setup

Setup guide

  1. 11. Open your Switchy workspace settings and navigate to the MCP Integrations page. 2. Click 'Add Integration' and select Postalytics from the catalog. 3. Log into your Postalytics account at app.postalytics.com, navigate to Settings > API Keys, and generate a new API key with full read/write permissions. 4. Paste the API key into the Switchy connection form and click 'Connect'. 5. Switchy will validate the key and confirm the connection within a few seconds. 6. Open any Space, type '@Postalytics' in the chat, and ask it to list your existing campaigns or contact lists — if it returns data, the integration is live. 7. To send your first mailing, you'll need to create a template using the 'Create Template' tool (provide front and back HTML or image URLs), proof it in Postalytics, then use 'Create New Campaign' to launch the send.

What teammates see: by default, memories from Postalytics are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Spaces have used this MCP together with a given model.

How Switchy teams use it

Not enough Spaces yet to publish anonymised usage stats (we require ≥ 50 Spaces per week).

Starter prompts

Create ABM Postcard Campaign

@Postalytics Create a new postcard campaign called 'Q1 ABM Outreach' using template ID 12345. Set the sender name to 'Sarah Chen' and return address to '123 Market St, San Francisco CA 94103'.
Open in a Space →

Add Contact to Mailing List

@Postalytics Add contact 'Alex Rivera' with email alex@example.com and address '456 Oak Ave, Austin TX 78701' to contact list ID 67890.
Open in a Space →

Build Postcard Template

@Postalytics Create a 6x9 postcard template called 'Spring Promo'. Front side uses image URL https://example.com/front.png, back side uses https://example.com/back.png.
Open in a Space →

Suppress Opted-Out Contacts

@Postalytics Create a suppression list called 'Unsubscribed Q1 2025', then add contact with email optout@example.com and address '789 Pine St, Seattle WA 98101'.
Open in a Space →

Set Up Delivery Webhook

@Postalytics Create a webhook pointing to https://myapp.com/postalytics-events that listens for sent, delivered, and returned events.
Open in a Space →

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@Postalytics show me all contacts on the 'Q1 Prospects' list who haven't been mailed in the last 30 days

Output

Based on the Q1 Prospects contact list, here are 47 contacts with no recent mail activity: • Sarah Chen (sarah@techcorp.com) — Last mailed: 62 days ago • Marcus Williams (m.williams@designstudio.io) — Last mailed: 45 days ago • Jennifer Park (jpark@retailgroup.com) — Never mailed [...44 more contacts] All contacts include verified mailing addresses. You can export this segment or launch a new campaign targeting these recipients.

Notes

This example shows Postalytics' contact list querying capability. The MCP can filter by mail history and contact metadata. Note that 'last mailed' tracking depends on campaign execution history in your account — contacts added recently may show as 'never mailed' even if they've received mail through other channels.

Prompt

@Postalytics create a postcard campaign called 'Spring Promo 2025' using the 'Product Launch' template, send to the 'Active Customers' list, exclude anyone on the 'Unsubscribed' suppression list

Output

Campaign 'Spring Promo 2025' created successfully (ID: cmp_8x3k9m). • Template: Product Launch (6x9 postcard) • Target list: Active Customers (1,203 contacts) • Suppression applied: Unsubscribed (87 contacts excluded) • Net recipients: 1,116 postcards • Estimated cost: $1,227.60 (printing + postage) Campaign is in draft status. Review the proof at postalytics.com/campaigns/cmp_8x3k9m, then approve to schedule mailing.

Notes

This demonstrates campaign creation with suppression list logic — a core workflow for compliance (GDPR, CAN-SPAM). The MCP returns cost estimates, but final pricing depends on address validation results. You must approve the campaign in the Postalytics UI before mail is sent; the MCP cannot auto-launch campaigns to prevent accidental sends.

Prompt

@Postalytics analyze delivery performance for all campaigns sent in March 2025 and draft a summary highlighting which audience segments had the best response rates

Output

March 2025 Campaign Performance Summary: **Highest Response Rate:** 'Reactivation Offer' campaign to lapsed customers (8.2% response, 340 conversions from 4,150 sends). This segment showed 3x better engagement than new prospects. **Delivery Issues:** 'New Product Intro' campaign had 12% undeliverable addresses in the 'Purchased List - Tech' segment, suggesting data quality problems. **Recommendation:** Prioritize lapsed customer segments for Q2 campaigns and validate purchased lists through an address verification service before mailing to reduce waste.

Notes

This synthesis example pairs Postalytics' campaign analytics with AI reasoning to surface actionable insights. The MCP provides raw delivery/response data; the AI interprets trends. Response rate tracking requires webhook integration or manual event logging — if webhooks aren't configured, response data may be incomplete or require manual upload from your CRM.

Use-case deep-dives

Automated direct mail for SaaS churn

When direct mail automation beats email for retention campaigns

A 6-person SaaS team runs a churn-prevention playbook: when a customer downgrades or cancels, they trigger a postcard with a personalized offer. The Postalytics MCP handles this if your team already uses direct mail as a channel and needs to automate it from your CRM or support tool. You create the template once, then use the 'Create New Campaign' and 'Add Contact' tools to fire campaigns from Switchy workflows tied to Stripe webhooks or Intercom events. The trade-off: this only makes sense if you're already spending on direct mail and have a template library. If you're testing the channel for the first time, build the workflow in Postalytics' UI before automating it here. Use this MCP when your retention motion is proven and you need to scale it without manual campaign setup.

Event follow-up postcard campaigns

Triggering physical mail from event attendance data

A 3-person events team runs quarterly trade shows and sends thank-you postcards to booth visitors within 48 hours. The Postalytics MCP wins here if you're pulling attendee lists from Airtable or a CRM and want to automate the mail drop without logging into Postalytics. You use 'Create New Campaign' and batch-add contacts from your attendee CSV, then track delivery via the 'Create Webhook' tool to log opens or responses back to your CRM. The boundary: if your event list is under 50 contacts, manual upload in Postalytics is faster. If you run more than 4 events a year or your list exceeds 200 names, the MCP saves 20 minutes per campaign by scripting the upload and suppression logic. This is the right call when direct mail is a repeatable part of your event playbook, not a one-off experiment.

Multi-account agency direct mail management

When sub-account provisioning justifies MCP overhead

A 5-person marketing agency manages direct mail campaigns for 12 clients, each with their own Postalytics sub-account. The MCP is the right tool if you're spinning up new client accounts weekly and need to automate template creation, contact list setup, and suppression rules across accounts. You use 'Add Account' to provision a new client workspace, 'Create Template' to clone your agency's base designs, and 'Create Suppression List' to enforce opt-out rules per client. The trade-off: this only pays off if you're managing 8+ client accounts or onboarding 2+ new clients per month. Below that threshold, the Postalytics UI is faster for one-off setups. Use this MCP when your agency workflow is templatized and you're automating client onboarding, not when you're running campaigns for a single brand.

Frequently asked

What does the Postalytics MCP do in Switchy?

It lets your team create and manage direct mail campaigns — postcards and letters — without leaving Switchy. You can build contact lists, design templates with HTML or image URLs, launch campaigns, and set up webhooks to track delivery events. All 24 tools map to Postalytics' API, so anything you'd do in their dashboard you can trigger from a Switchy chat.

Do I need admin access to connect Postalytics?

You need an API key from your Postalytics account. Any user with permission to generate API keys can connect it. If your team uses sub-accounts, the MCP can create and delete those too, but you can't delete the parent account via the integration. Whoever connects it controls which campaigns and lists Switchy can touch.

Can the MCP send mail to individual contacts on the fly?

Not directly. You create a campaign with a template, then add contacts to a list, then trigger the send. The MCP doesn't have a single "mail this person now" tool — it follows Postalytics' campaign workflow. If you need one-off sends, you'd still create a micro-campaign with one contact. Suppression lists let you exclude people across campaigns.

How is this different from using Postalytics' dashboard?

Same underlying API, different interface. The MCP is faster for bulk operations — like adding 50 contacts or setting up webhooks for multiple campaigns — because you script it in chat instead of clicking through forms. You lose the visual template editor, though. If your team already writes HTML for mail pieces, the MCP is a shortcut. If you rely on drag-and-drop design, stick to the dashboard.

Who on the team should connect this integration?

Whoever manages your direct mail budget and has the Postalytics API key. The MCP can create sub-accounts and delete them, so you want someone who understands your account structure. If multiple people run campaigns, consider connecting it under a shared service account in Switchy so the API key isn't tied to one person's login.

Data last verified 607 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.