Mandrill is a powerful transactional email service built by Mailchimp, designed for sending automated, one-to-one emails such as password resets, order confirmations, invoices, and account notifications.

Integration setup is quick, easy, and guaranteed to save your business valuable time.

Note: Mandrill may occasionally delay (backlog) email delivery for various reasons. When this happens, emails might not be sent immediately. For a complete list of possible causes and guidance on resolving them, refer to Mandrill’s official documentation.

Mandrill Setup

Setup a Template in Mandrill

• Go to Outbound → Templates.
• Click “Create a Template”.

• Enter a name for your template (e.g., “Subscription Confirmation”).
• Add your HTML email content (you can use merge tags and placeholders for personalization).

• Save and publish the template. Please note that your domain needs to be verified in order for the emails to be sent.

Get Your Mandrill API Key

• In Mandrill, go to Settings → SMTP & API Info.
• Under API Keys, click Add API Key.
• Copy the key shown — you’ll need it for Pelcro. For security, only use this key within Pelcro.

Connect Mandrill to Pelcro

• Log in to your Pelcro Admin Dashboard.
• Go to Settings → Integrations → Web & Communications → Mandrill .
• Paste your Mandrill API Key into the field provided.
• Configure the sender email and name into the fields provided.

Map Templates in Pelcro

• In the same Mandrill integrations page, you can map the templates you created in Mandrill to specific Pelcro events (e.g., Subscription Created, Invoice Paid, Password Reset).
• In the Template Name field, enter the exact Mandrill template slug from your Mandrill account.

• When mapping templates in Pelcro’s Mandrill Integration page, you also have flexibility in how data appears in your emails:

  • Date Formatting You can specify the exact format you’d like dates to appear in your emails (e.g., MM/DD/YYYY, August 21, 2025, etc.). This ensures consistency with your organization’s preferred style.
  • Boolean Formatting You can automatically format boolean values (true/false) to display as “Yes” or “No” by enabling the provided checkbox. This makes your emails more user-friendly and readable.
  

Event Handlebar Reference

Event handlebars are placeholders you can insert into your Mandrill templates to display event-specific data.

When Pelcro triggers an event (e.g., Subscription Created, Invoice Paid), these placeholders are automatically replaced with the actual values from that event.

For example:

<p>Hello {{first_name}},</p>
<p>Your subscription started on {{created_at}}.</p>

Note:
If a customer has a billing email defined, all billing-related events (such as invoice.created, charge.succeeded, etc.) will be sent to that billing email.
If no billing email is defined, these notifications will be sent to the customer’s primary email address.

Customer Events

Customer.created/ Customer.updated

Handlebars:

id
email
first_name
last_name
full_name
display_name
title
username
phone
salutation
organization
balance
currency
has_password
created_at
updated_at
last_login_method
metadata
site_id

Customer.password.reset

Handlebars:

id
email
first_name
last_name
full_name
display_name
title
username
phone
salutation
organization
balance
currency
has_password
created_at
updated_at
last_login_method
metadata
site_id
password_reset_token

Customer.password.updated

Handlebars:

id
email
first_name
last_name
full_name
display_name
title
username
phone
salutation
organization
balance
currency
has_password
created_at
updated_at
last_login_method
metadata
site_id
password_last_updated_at

Customer.passwordless

Handlebars:

id
email
first_name
last_name
full_name
display_name
title
username
phone
salutation
organization
balance
currency
has_password
created_at
updated_at
last_login_method
metadata
site_id
password_last_updated_at
passwordless_login_token

Subscription Events

The below handlebars are available to the below subscription events:

• subscription.canceled
• subscription.expired
• subscription.renewed
• subscription.trial_will_end
• subscription.updated

Handlebars:

id
shipping_address_id
coupon
customer_default_source_id
latest_invoice_id
billing
cancel_at_period_end
canceled_at
cancel_reason
created_at
current_period_end
current_period_start
days_until_due
ended_at
renews_at
expires_at
quantity
status
trial_end
trial_start
shipments_remaining
shipments_undeliverable
shipments_suspended_until
plan_nickname
plan_id
plan_amount
plan_currency
plan_auto_renew
plan_product_id
plan_product_description
plan_product_name
plan_interval
plan_interval_count
plan_trial_period_days
address_shipping_updated_at
address_shipping_city
address_shipping_country
address_shipping_line1
address_shipping_line2
address_shipping_postal_code
address_shipping_state
latest_invoice_address_billing_updated_at
latest_invoice_address_billing_city
latest_invoice_address_billing_country
latest_invoice_address_billing_line1
latest_invoice_address_billing_line2
latest_invoice_address_billing_postal_code
latest_invoice_address_billing_state
plan_product_address_required
customer_id
customer_first_name
customer_last_name
customer_email
site_id

Subscription.created

Handlebars:

is_free
is_digital
id
shipping_address_id
coupon
customer_default_source_id
latest_invoice_id
billing
cancel_at_period_end
canceled_at
cancel_reason
created_at
current_period_end
current_period_start
days_until_due
ended_at
renews_at
expires_at
quantity
status
trial_end
trial_start
shipments_remaining
shipments_undeliverable
shipments_suspended_until
plan_nickname
plan_id
plan_amount
plan_currency
plan_auto_renew
plan_product_id
plan_product_description
plan_product_name
plan_interval
plan_interval_count
plan_trial_period_days
address_shipping_updated_at
address_shipping_city
address_shipping_country
address_shipping_line1
address_shipping_line2
address_shipping_postal_code
address_shipping_state
latest_invoice_address_billing_updated_at
latest_invoice_address_billing_city
latest_invoice_address_billing_country
latest_invoice_address_billing_line1
latest_invoice_address_billing_line2
latest_invoice_address_billing_postal_code
latest_invoice_address_billing_state
plan_product_address_required
customer_id
customer_first_name
customer_last_name
customer_email
site_id

Subscription.gift_notification

Handlebars:

id
billing
billing_cycle_anchor
canceled_at
cancel_reason
created_at
current_period_end
current_period_start
latest_invoice_id
quantity
site_id
source
status
plan_nickname
plan_id
plan_amount
plan_product_name
plan_product_description
plan_interval
plan_interval_count
customer_first_name
customer_last_name
is_gift_recipient
is_gift_donor
gift_code
is_redeemed
gift_recipient_email
gift_recipient_first_name
gift_recipient_last_name
gift_start_date
gift_message
gift_donor_subscription_id

Invoice Events

The following handlebars are available and will apply to all invoice-related events:

• Invoice Created
• Invoice Updated
• Payment Succeeded
• Payment Failed
• Payment Action Required
• Upcoming Invoice

Handlebars:

id
amount_due
amount_paid
amount_remaining
auto_advance
billing
billing_reason
currency
ending_balance
hosted_invoice_url
invoice_pdf
is_imported
number
period_start
period_end
post_payment_credit_notes_amount
pre_payment_credit_notes_amount
starting_balance
status
subtotal
tax
total
finalized_at
marked_uncollectible_at
paid_at
voided_at
created_at
updated_at
deleted_at
purchase_order
customer_id
customer_first_name
customer_last_name
customer_email
address_shipping_city
address_shipping_country
address_shipping_line1
address_shipping_line2
address_shipping_postal_code
address_shipping_state
address_billing_city
address_billing_country
address_billing_line1
address_billing_line2
address_billing_postal_code
address_billing_state
lines_data_subscription_days_until_due
lines_data_subscription_plan_nickname
lines_data_subscription_plan_amount
lines_data_subscription_plan_id
lines_data_subscription_plan_product_name
lines_data_subscription_plan_product_description
lines_data_subscription_plan_product_id
site_id

Member Events

The following handlebars are available and will apply to the following:

• member.activated
• member.created
• member.deleted

Handlebars:

id
subscription_id
status
invitation_email
site_id
subscription_billing
subscription_cancel_at
subscription_cancel_at_period_end
subscription_canceled_at
subscription_renews_at
subscription_expires_at
subscription_current_period_start
subscription_days_until_due
subscription_ended_at
subscription_quantity
subscription_status
subscription_plan_nickname
subscription_plan_id
subscription_plan_amount
subscription_plan_auto_renew
subscription_plan_product_id
subscription_plan_product_description
subscription_plan_product_name
subscription_plan_interval
subscription_plan_interval_count
subscription_plan_trial_period_days
subscription_plan_product_address_required
subscription_plan_domains
subscription_plan_entitlements
currency
customer_id
customer_first_name
customer_last_name
customer_email

Order Events

The following handlebars are available to order.created.

Handlebars:

id
amount
currency
status
created_at
site_id
address_id
address_first_name
address_last_name
address_line1
address_line2
address_city
address_state
address_country
address_postal_code
address_company
address_phone
customer_id
customer_first_name
customer_last_name
customer_email
customer_phone
email
customer_email
first_name
last_name
charge_id
charge_amount
charge_currency
charge_status
charge_description
charge_receipt_url
charge_receipt_number
invoice_id
invoice_amount_due
invoice_amount_paid
invoice_currency
invoice_status
invoice_invoice_pdf
invoice_receipt_url
items
total

Payment Method Events

The following handlebars are available to the below payment methods events:

• source.canceled
• source.created
• source.expired
• source.expiring
• source.updated

Handlebars:

id
brand
country
cvc_check
exp_month
exp_year
funding
last4
name
three_d_secure
customer_id
customer_name
customer_email
site_id

Campaign Events

Campaign.triggered

Handlebars:

campaign_name
campaign_key
campaign_plan_id
campaign_plan_amount
campaign_plan_nickname
campaign_plan_product_id
campaign_plan_product_name
subscription_id
subscription_address_line1
subscription_address_line2
subscription_address_city
subscription_address_state
subscription_address_country
subscription_address_postal_code
subscription_user_id
subscription_user_first_name
subscription_user_last_name
subscription_user_email
site_id
currency

Charge Events

Charge.succeeded/ Charge.refunded

Handlebars:

id
amount
amount_refunded
created_at
currency
description
customer_id
customer_first_name
customer_last_name
customer_email
invoice_id
invoice_amount_due
invoice_amount_paid
invoice_amount_remaining
invoice_billing
invoice_billing_reason
invoice_charge_id
invoice_created_at
invoice_currency
invoice_hosted_invoice_url
invoice_invoice_pdf
invoice_lines_id
invoice_lines_amount
invoice_lines_created_at
invoice_lines_description
invoice_lines_period_end
invoice_lines_period_start
invoice_lines_quantity
invoice_lines_subscription_id
invoice_lines_subscription_auto_renew
invoice_lines_subscription_billing
invoice_lines_subscription_cancel_at_period_end
invoice_lines_subscription_canceled_at
invoice_lines_subscription_created_at
invoice_lines_subscription_current_period_end
invoice_lines_subscription_current_period_start
latest_invoice_id
latest_invoice_source_id
latest_invoice_source_brand
latest_invoice_source_exp_month
latest_invoice_source_exp_year
latest_invoice_source_last4
site_id