Postmark

Integration

Postmark

Plandalf integrates with Postmark as a email, website, sdk platform.

What it does

Product surfaces

Where Postmark fits in the buying workflow

Integrations work best when the checkout surface, payment state, invoice record, and post-purchase automation all point at the same commercial object. These product screens show the Plandalf controls that should be configured before Postmark receives checkout, payment, tax, or workflow context.

The Numi offer editor showing layout, product, theme, automation, invoice, and settings controls.
The Numi checkout elements palette showing content, interactive, and selling blocks.
The Numi offer editor automation tab showing sequence controls beside the checkout canvas.

Purchase events can start follow-up

Postmark should fit into the work after checkout: fulfilment, records, CRM updates, support context, webhooks, and sequences.

The Numi offer editor showing hosted checkout mode controls.

Builder paths

Stack guides that use Postmark

Use these stack guides when a builder needs the whole path: sales surface, Plandalf offer, payment handoff, automation, fulfilment, records, and downstream integrations.

Overview

Postmark is a transactional email provider. There’s no built-in workflow builder for promo enrolment; that flow runs through Zapier or a Custom API call from the backend that triggers each Postmark send.

What Plandalf does here

  • Countdown in templates — Mustachio {{email}} resolves against the template model your backend passes on the Email Send API call.

Setup templates

Drop-in implementations

Copy-paste setups for the most common ways to wire Postmark into Plandalf.

promo · email

Drop the Plandalf countdown image into a Postmark template

In your Postmark template (Mustachio syntax), paste this <img> tag into the HTML editor. {{email}} resolves against whatever model you pass when calling the Email Send API.

<img
  src="{{ promo.countdown_url }}?ref={{email}}"
  alt="Time remaining on this offer"
/>

Ensure the template-model payload on your send call includes the recipient's address under email — or substitute whichever field name you use (to, recipient, etc.).

Automation graph

Connecting Postmark

How Postmark participates in Plandalf sequences: what events it exposes upward, and what actions Plandalf can perform on it.

Triggers from Postmark

Events Plandalf can subscribe to through webhooks, API work, checkout state, payment context, and connected integrations.

postmark.subscriber_added
Fires when a new subscriber is added to Postmark.
postmark.webhook
Fires when Postmark POSTs to a Plandalf webhook URL — use for anything not covered by a native trigger.

Actions on Postmark

Things Plandalf sequences can do after checkout, payment, invoice, customer, or deadline events.

postmark.add_subscriber
Add a contact to a list or audience in Postmark.
postmark.tag
Apply a tag or segment to an existing Postmark contact.
postmark.send_email
Send a one-off transactional or broadcast email through Postmark.
postmark.custom_api_call
Hit any Postmark REST endpoint with a templated payload.

Embeddable surfaces: Plandalf countdown image and buy button HTML · Per-recipient countdown GIF with merge-tag substitution

Example sequence
trigger: stripe.payment_succeeded
actions:
  - postmark.add_subscriber:
      list: paying-customers
      tag: tier-${plan}
  - plandalf.grant_entitlement: ${product_slug}

Integration methods

How Postmark connects to Plandalf

Each method below is the minimum viable setup. Pick the one closest to how you already use Postmark with checkout, payments, invoices, webhooks, API work, SDK checkout, and integrations.

  1. Method 1

    Embed a Plandalf buy button

    Drop the Plandalf embed script into a Postmark HTML block and tag any element with `data-plandalf-present` to open the configured flow on click.

    <script src="https://cdn.plandalf.com/embed.js" async></script>
    
    <button data-plandalf-present="offer_abc123">
      Buy now
    </button>
  2. Method 2

    Drop in a per-recipient countdown image

    Add an HTML block to any Postmark email and paste the Plandalf countdown URL. Postmark's merge tag `{{ email }}` substitutes per recipient so each subscriber sees a timer pegged to their own deadline.

    <img
      src="https://cdn.plandalf.com/timers/{TIMER_ID}.gif?ref={{ email }}"
      alt="Time remaining on this offer"
      width="600"
      height="120"
    />
  3. Method 3

    REST API webhook

    For anything not covered by a native trigger, configure a Postmark webhook to POST to Plandalf. The payload is forwarded into the sequence as `${event}`.

    curl -X POST https://api.plandalf.com/v1/webhooks/postmark \
      -H "Authorization: Bearer $PLANDALF_API_KEY" \
      -H "Content-Type: application/json" \
      -d @event.json
Official Postmark docs and sign-up: postmarkapp.com

FAQ

Common questions about the Postmark integration

Do I need a paid plan to use Postmark with Plandalf?

Plandalf itself is free to connect to Postmark. You only need a Postmark account that allows API access, which is almost every paid plan.

How long does setup take?

Under 10 minutes. OAuth (or paste an API key), pick the lists/segments you care about, and you're live. No code unless you want it.

Can I disconnect Postmark later without losing data?

Yes. Disconnecting only revokes the credentials — historical events Plandalf fired stay in your sequence logs, and Postmark's own records are untouched. You can reconnect any time and resume from the last seen event.

Does Plandalf store Postmark data?

Plandalf stores the Postmark contact ID and the events Plandalf fired against that contact. Email content stays in Postmark; Plandalf doesn't mirror your audience or newsletter archive.

What if my email need isn't covered by the actions or triggers listed here?

Use the generic `postmark.custom_api_call` action or the inbound `postmark.webhook` trigger. Anything Postmark's REST API can do, a Plandalf sequence can drive.

Is there a usage limit?

Plandalf respects Postmark's API rate limits and backs off on 429s. For very high-volume use cases, ask about a dedicated worker pool.

Where do I find Postmark's own documentation?

Postmark's homepage at https://postmarkapp.com links to their developer docs. For Plandalf-side questions about the Postmark integration, see the Plandalf docs.

Feature detail