Campagnes

curl -X POST https://api.lekalao.com/v1/campaigns \
  -H "Authorization: Bearer $LEKALAO_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "name": "Lettre de septembre",
    "subject": "Les pains de la rentrée",
    "list": "9d5c2a1e-8f3b-4c7a-9e21-3b8f0c6d4a12",
    "editor": "markdown",
    "content": "# La rentrée\n\nBonjour {{ subscriber.first_name }},\n\n…\n\n[Se désabonner]({{ unsubscribe_url }})  \n{{ organisation.address }}",
    "track_opens": true,
    "track_clicks": true
  }'

curl -X POST https://api.lekalao.com/v1/campaigns/$CAMPAIGN/test \
  -H "Authorization: Bearer $LEKALAO_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{ "recipients": ["redaction@maboulangerie.example"] }'

{ "message": "Test e-mail sent to redaction@maboulangerie.example.", "recipients": ["redaction@maboulangerie.example"], "sandbox": false }

curl -X POST https://api.lekalao.com/v1/campaigns/$CAMPAIGN/send \
  -H "Authorization: Bearer $LEKALAO_TOKEN" \
  -H "Accept: application/json" \
  -H "Idempotency-Key: campagne-septembre-envoi"

{ "message": "1284 e-mails are on their way.", "queued": 1284 }

{
    "message": "This campaign cannot be sent yet.",
    "code": "campaign_not_ready",
    "doc_url": "https://docs.lekalao.com/errors#campaign_not_ready",
    "problems": [
        "Configure a mailer in the settings.",
        "Add your postal address to the content, with {{ organisation.address }}."
    ]
}

curl https://api.lekalao.com/v1/campaigns/$CAMPAIGN \
  -H "Authorization: Bearer $LEKALAO_TOKEN" -H "Accept: application/json"

{
    "data": {
        "id": "0c9e3f5a-…",
        "name": "Lettre de septembre",
        "subject": "Les pains de la rentrée",
        "status": "sent",
        "list": "9d5c2a1e-…",
        "scheduled_at": null,
        "sent_at": "2026-09-17T08:00:12+00:00",
        "statistics": {
            "recipients": 1284,
            "sent": 1284,
            "delivered": 1270,
            "opens": 812,
            "unique_opens": 655,
            "clicks": 190,
            "unique_clicks": 141,
            "bounces": 9,
            "complaints": 0,
            "unsubscribes": 4
        },
        "created_at": "2026-09-16T15:40:02+00:00"
    }
}