Recipient definition

📌 Partial retries
When you send a JobRequest with multiple recipients into the same payload, asynchronous processing includes a mechanism to reprocess only the failed deliveries separately. That approach prevents the delivery of the same email multiple times to recipients who were part of a previous successful attempt.

The following explains how to define recipients correctly.

Case 1

Recipients will receive the same email but can see each other (like you would enter both addresses in your email client into the “to” field).

JSON

"recipients": [{
                "mail": {
                   "to": [{"email":"recipient01@dn.com"},{"email":"recipient02@ dn.com"}],
              },
    },
    {...<next recipient-block>...}
  ],

Case 2

Recipients will receive the same email but cannot see each other.

JSON

"recipients":[{
             "mail":{
                "to":[{"email":"recipient01@dn.com"}],
             },
    },
    {
            "mail":{
                "to":[{"email":"recipient02@dn.com"}],
            },
    },
    {...<next recipient-block>...}
  ],

Case 3

Combined. All named email addresses together can have up to 1.000 recipients, no matter the way they’ve been defined.

JSON

"recipients":[{
                "mail":{
                  "to":[{"email":"recipient01@dn.com"},{"email":"recipient02@dn.com"}],
              },
      },
    {
                "mail":{
                  "to":[{"email":"recipient03@dn.com"}],
                },
    },
    {...<next recipient-block>...}
  ],