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.

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>

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