- Update an email batch
Updates batch metadata and email template options. To submit a Draft or Invalid batch, send State Submitted and a future UTC ScheduledDate in the same request. To return a Submitted or Scheduled batch to editable state, send State Draft. Omitted or empty AcceptReasons and RejectReasons clear the stored lists. Before submission, the batch needs a body and at least one recipient, plus Subject, a permitted From, TimeToLive greater than 0, OnlineRetentionPeriod from 1 to 20 years, CommitmentOptions, and CertificationLevel. New batches have no defaults for these fields.
Future execution date and time in UTC. Required when submitting a Draft or Invalid batch.
Set Submitted to submit an editable batch or Draft to return a Submitted or Scheduled batch to editing.
Enables post-close LTA storage for every email generated from the batch. Each email is stored after its own tracking reaches Closed. Requires LTA to be enabled for the site.
Push notification URL propagated to every email generated from the batch — it becomes each email's own callback URL for the normal per-email lifecycle callbacks. Alias of BatchPushNotificationUrl (both set the same value; if both are supplied, this one is applied last). The batch itself has no separate lifecycle callback — track batch progress with GET .../{BatchId}.
Alias of PushNotificationUrl — both set the same value. It is propagated to every email generated from the batch as that email's own callback URL; the batch has no separate lifecycle callback. Track batch progress with GET .../{BatchId}.
- https://api.evicertia.comhttps://api.evicertia.com/v2/EviMail/Batches/{BatchId}
- https://api.ecertia.comhttps://api.ecertia.com/v2/EviMail/Batches/{BatchId}
curl -i -X PATCH \
-u '<username>:<password>' \
'https://api.evicertia.com/v2/EviMail/Batches/{BatchId}' \
-H 'Content-Type: application/json' \
-d '{
"Subject": "Your March statement",
"From": "sender@example.com",
"TimeToLive": 1440,
"OnlineRetentionPeriod": 1,
"CommitmentOptions": "Disabled",
"IssuerName": "Sender Corp.",
"CertificationLevel": "Advanced_EU",
"Language": "en",
"State": "Submitted",
"ScheduledDate": "2030-04-01T09:00:00Z"
}'