--- updatedAt: 2025-10-30T22:33:07.000Z agentTools: projectIndex: https://docs.pelcro.com/v2.4/llms.txt --- # Mandrill 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](https://mailchimp.com/developer/transactional/docs/). # 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: ```

Hello {{first_name}},

Your subscription started on {{created_at}}.

```
> **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 ``` # Sibling pages * [Dialog Insight](https://docs.pelcro.com/v2.4/docs/dialog-insight.md) * [Darwin CX](https://docs.pelcro.com/v2.4/docs/darwin-cx.md) * [Google Tag Manager](https://docs.pelcro.com/v2.4/docs/google-tag-manager.md) * [Klaviyo](https://docs.pelcro.com/v2.4/docs/klaviyo.md) * [Mailchimp](https://docs.pelcro.com/v2.4/docs/mailchimp.md) * [MAPP Empower](https://docs.pelcro.com/v2.4/docs/mapp.md) * [Omeda](https://docs.pelcro.com/v2.4/docs/omeda.md) * [SendGrid](https://docs.pelcro.com/v2.4/docs/sendgrid.md) * [Zapier](https://docs.pelcro.com/v2.4/docs/zapier.md)