> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.
# MailerLite
> Automatiskt lägga till kunder i MailerLite prenumerantlistor och utlösa e-postautomatiseringar baserat på Dodo Payments-händelser.
## Introduktion
Automatiskt synkronisera dina betalande kunder till MailerLite prenumerantlistor när betalningshändelser inträffar. Lägg till kunder i specifika grupper, utlös automatiseringsarbetsflöden och håll dina e-postmarknadsföringslistor uppdaterade med verkliga betalningsdata.
MailerLite är en kraftfull plattform för e-postmarknadsföring för nyhetsbrev, kampanjer och automatiseringar. Denna integration hjälper dig att automatiskt hantera prenumeranter baserat på betalningsaktivitet - perfekt för onboarding-sekvenser, kundsegmentering och riktade marknadsföringskampanjer.
Denna integration kräver din MailerLite API-nyckel för autentisering. Du kan skapa en från din [MailerLite integrationssida](https://dashboard.mailerlite.com/integrations/api).
## Komma igång
I din Dodo Payments-instrumentpanel, navigera till Webhooks + Lägg till Endpoint och expandera rullgardinsmenyn för integrationer.
Välj MailerLite-integrationskortet.
Ange din MailerLite API-nyckel i konfigurationen.
Redigera transformationskoden för att formatera prenumerantdata för MailerLites API.
Testa med exempelpayloads och klicka på Create för att aktivera prenumerantsynkroniseringen.
Betalningshändelser kommer nu automatiskt synkronisera kunder till dina MailerLite-listor.
## Transformationskodexempel
### Lägg till kund vid lyckad betalning
```javascript add_customer.js icon="js" expandable theme={null}
function handler(webhook) {
if (webhook.eventType === "payment.succeeded") {
const p = webhook.payload.data;
webhook.url = "https://connect.mailerlite.com/api/subscribers";
webhook.payload = {
email: p.customer.email,
fields: {
name: p.customer.name,
company: p.customer.business_name || "",
last_name: ""
},
groups: ["your-group-id-here"],
status: "active"
};
}
return webhook;
}
```
### Lägg till prenumerant i flera grupper baserat på produkt
```javascript product_segmentation.js icon="js" expandable theme={null}
function handler(webhook) {
if (webhook.eventType === "payment.succeeded") {
const p = webhook.payload.data;
// Determine groups based on product or amount
const groups = ["customers-group-id"];
// Add to premium group if high-value purchase
if (p.total_amount >= 10000) { // $100+
groups.push("premium-customers-group-id");
}
webhook.url = "https://connect.mailerlite.com/api/subscribers";
webhook.payload = {
email: p.customer.email,
fields: {
name: p.customer.name,
last_purchase_amount: (p.total_amount / 100).toFixed(2),
last_purchase_date: new Date(webhook.payload.timestamp).toISOString().split('T')[0],
payment_id: p.payment_id
},
groups: groups,
status: "active"
};
}
return webhook;
}
```
### Lägg till ny prenumerant vid aktivering av prenumeration
```javascript subscription_subscriber.js icon="js" expandable theme={null}
function handler(webhook) {
if (webhook.eventType === "subscription.active") {
const s = webhook.payload.data;
webhook.url = "https://connect.mailerlite.com/api/subscribers";
webhook.payload = {
email: s.customer.email,
fields: {
name: s.customer.name,
subscription_plan: s.product_id,
subscription_amount: (s.recurring_pre_tax_amount / 100).toFixed(2),
billing_frequency: s.payment_frequency_interval,
subscription_start: new Date().toISOString().split('T')[0]
},
groups: ["subscribers-group-id", "active-subscriptions-group-id"],
status: "active"
};
}
return webhook;
}
```
### Uppdatera prenumerant vid avbokning av prenumeration
```javascript subscription_cancelled.js icon="js" expandable theme={null}
function handler(webhook) {
if (webhook.eventType === "subscription.cancelled") {
const s = webhook.payload.data;
// Use PUT to update existing subscriber
webhook.url = "https://connect.mailerlite.com/api/subscribers/" + encodeURIComponent(s.customer.email);
webhook.method = "PUT";
webhook.payload = {
fields: {
subscription_status: "cancelled",
cancellation_date: new Date().toISOString().split('T')[0]
},
groups: ["churned-customers-group-id"]
};
}
return webhook;
}
```
### Lägg till kund med anpassade fält
```javascript custom_fields.js icon="js" expandable theme={null}
function handler(webhook) {
if (webhook.eventType === "payment.succeeded") {
const p = webhook.payload.data;
webhook.url = "https://connect.mailerlite.com/api/subscribers";
webhook.payload = {
email: p.customer.email,
fields: {
name: p.customer.name,
company: p.customer.business_name || "",
country: p.customer.country || "",
city: p.customer.city || "",
phone: p.customer.phone || "",
// Custom fields (must be created in MailerLite first)
total_spent: (p.total_amount / 100).toFixed(2),
customer_since: new Date().toISOString().split('T')[0],
payment_method: p.payment_method || "unknown",
currency: p.currency || "USD"
},
groups: ["paying-customers-group-id"],
status: "active",
subscribed_at: new Date().toISOString().replace('T', ' ').split('.')[0]
};
}
return webhook;
}
```
### Utlösa automatisering via händelse
```javascript trigger_automation.js icon="js" expandable theme={null}
function handler(webhook) {
if (webhook.eventType === "payment.succeeded") {
const p = webhook.payload.data;
// First, ensure subscriber exists
webhook.url = "https://connect.mailerlite.com/api/subscribers";
webhook.payload = {
email: p.customer.email,
fields: {
name: p.customer.name,
// Add a trigger field that your automation watches
last_payment_trigger: new Date().toISOString(),
last_payment_amount: (p.total_amount / 100).toFixed(2)
},
status: "active"
};
// Tip: Create an automation in MailerLite that triggers
// when 'last_payment_trigger' field is updated
}
return webhook;
}
```
## Tips
* Skapa anpassade fält i MailerLite innan du använder dem i dina transformationer
* Använd grupper för att segmentera kunder efter produkt, plan eller köpbeteende
* Ställ in automatiseringsarbetsflöden i MailerLite som utlöses vid fältuppdateringar
* Använd upsert-beteendet (POST till /subscribers) för att undvika dubblettprenumerantfel
* Lagra betalningsmetadata i anpassade fält för bättre kundinsikter
* Testa med en liten grupp innan du aktiverar för alla betalningar
## Inställning av anpassade fält
Innan du använder anpassade fält måste du skapa dem i MailerLite:
1. Gå till din MailerLite-instrumentpanel
2. Navigera till **Subscribers Fields**
3. Klicka på **Create field** och lägg till fält som:
* `total_spent` (Number)
* `customer_since` (Date)
* `subscription_plan` (Text)
* `payment_method` (Text)
* `last_payment_amount` (Number)
## Felsökning
* Kontrollera att API-nyckeln är korrekt och aktiv
* Säkerställ att e-postadressen är giltig (RFC 2821-kompatibel)
* Verifiera att grupp-ID:n är korrekta och existerar i ditt konto
* Observera: Avprenumererade, studsade eller skräppostprenumeranter kan inte aktiveras igen via API
* Bekräfta att anpassade fält finns i MailerLite innan de används
* Kontrollera att fältnamnen matchar exakt (skiftlägeskänsligt)
* Se till att fältvärdena matchar förväntad typ (text, number, date)
* MailerLite-API:et har en gräns på 120 förfrågningar per minut
* Använd batch-endpoints vid hantering av många prenumeranter
* Implementera backoff-strategier i scenarier med hög volym
* Kontrollera att grupp-ID:n är numeriska strängar
* Verifiera att grupperna finns i ditt MailerLite-konto
* Observera: Att använda PUT med grupper tar bort prenumeranten från grupper som inte listas
## API-referens
MailerLite Prenumeranter API accepterar följande nyckelparametrar:
| Parameter | Type | Required | Description |
| ------------------ | ------ | -------- | -------------------------------------------------------- |
| `email` | string | Yes | Giltig e-postadress (RFC 2821) |
| `fields` | object | No | Objekt med fältnamn/-värde-par |
| `fields.name` | string | No | Prenumerantens förnamn |
| `fields.last_name` | string | No | Prenumerantens efternamn |
| `fields.company` | string | No | Företagsnamn |
| `fields.country` | string | No | Land |
| `fields.city` | string | No | Stad |
| `fields.phone` | string | No | Telefonnummer |
| `groups` | array | No | Array med grupp-ID:n som prenumeranten ska läggas till i |
| `status` | string | No | Ett av: active, unsubscribed, unconfirmed, bounced, junk |
| `subscribed_at` | string | No | Datum i format `yyyy-MM-dd HH:mm:ss` |
| `ip_address` | string | No | Prenumerantens IP-adress |
För fullständig API-dokumentation, besök [MailerLite Developers](https://developers.mailerlite.com/docs/subscribers.html).