molted lists

molted lists create --name "Weekly Digest" --type newsletter --double-opt-in
# -> {"id":"<listId>","name":"Weekly Digest","type":"newsletter","doubleOptIn":true,"subscriberCount":0,...}

molted lists subscribe <listId> --email alice@example.com --name "Alice"
# -> {"id":"...","listId":"<listId>","contactId":"...","status":"pending","source":"api",...}
# "active" on a single opt-in list. On a double opt-in list the subscriber
# stays "pending": the API emits a list.subscribe.pending event with a
# confirmationUrl but sends no email itself, so a journey triggered on that
# event must send the confirmation. A suppressed address is refused (400);
# an address that unsubscribed earlier comes back "unsubscribed".

molted lists import <listId> --file contacts.csv
# -> {"total":153,"subscribed":150,"pending":0,"skipped":3,"failed":0,
#     "skippedReasons":{"previously_unsubscribed":3}}

molted lists send <listId> --template welcome --yes
# -> {"id":"...","status":"completed","subscriberCount":153,"sent":150,
#     "blocked":2,"failed":1,"blockedReasons":{"suppressed":2},...}
# status becomes "failed" when sent === 0 (every attempt was blocked or failed).
# Inspect blockedReasons to see why (e.g. trial_not_activated,
# suppressed, hourly_limit_exceeded).
# The list must be active with 1 to 500 active subscribers (400 otherwise).
# A broadcast is always exempt from requireConsentForMarketing (settings):
# the active subscription itself is the consent, so it never blocks with
# no_consent, whatever that tenant setting is set to. A double opt-in
# confirmation email is exempt the same way.

molted lists sends <listId>
# -> [{"sendId":"...","sentAt":"...","subscriberCount":153,"status":"completed",
#      "templateId":"welcome","delivered":148,"bounced":2,"opened":60,"clicked":12}]
# The latest 50 broadcasts, newest first.

molted lists stats <listId>
# -> {"subscriberCount":153,"pendingCount":2,"unsubscribedCount":5,"totalSends":12,"lastSentAt":"..."}

molted lists create [options]

molted lists list [options]

molted lists get <id>

molted lists update [options] <id>

molted lists archive <id>

molted lists subscribe [options] <listId>

molted lists unsubscribe [options] <listId>

molted lists subscribers [options] <listId>

molted lists import [options] <listId>

[
  {"email": "alice@example.com"},
  {"email": "bob@example.com"}
]

molted lists import <listId> --file contacts.csv
molted lists import <listId> --file subscribers.json

molted lists send [options] <listId>

molted lists sends [options] <listId>

molted lists stats [options] <listId>