Registered Email

Registered Email service helps companies with digitizing important document flows in a secure and easy way with GDPR compliance. In addition, Registered Email provides an enhanced proof of delivery, in line with the EU 910/2014 regulation (eIDAS).

For Sender:

This service can be integrated into your existing systems used in your organization.

Following a regular email process, you can prepare the registered email and send it to the recipient within the trusted email environment with just one push of a button.
You can follow the status of the email in real-time with the ticket using your email account, which also provides a legal proof of delivery.

For Receiver:

The users can read and accept the registered e-mails using their own trusted email client.

After receiving the announcement, the user may request or refuse it. If accepted, the user receives the original email from the sender immediately and securely.

To ensure a smooth start with the Registered Email API, your business should meet the following conditions:

Good knowledge of automation.
Experience with JSON
Permanently available security expertise to use Registered Email API and safeguarding its security.

Using the API

After your account set up is complete, subscribe the Registered Email API to your application.

📘
For production access you require a token provided by our partner. To obtain this token, reach us through the contact form in the 'Support' tab.
Aangetekend Mailen provides customer-specific tokens by Registered Email.

Rate Limiting

A default rate limit plan is set for all APIs. The rate limit can be shared or individual (defined per operation). The table below describes the rate limiting for this product.

Operation	Type	Limit (API calls / s)	Counts towards shared limit
`POST /mail/send`	Shared	6	Yes

Request

You can initiate sending a Registered Email with POST /api/v2.0/mail/send.

POST https://api-sandbox.rabobank.nl/openapi/sandbox/api/v2.0/mail/send

Response

After receiving the email, an ID is returned in the response.

Example:

{
    "id": "16"
}

Test in Sandbox

Use the following example body for Sandbox. You need to fill in the recipients email and you can replace the other values with your own information.

{
  "content": {
    "html": "<!doctype html><html><body>Please approve our new logo: <img src='cid:newlogo'></body></html>",
    "text": "Please approve the attached new logo.",
    "inline": [
      {
        "cid": "newlogo",
        "content": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAIAAACQd1PeAAAADElEQVQIW2Pg/8IPAAIoAROapGHUAAAAAElFTkSuQmCC"
      }
    ]
  },
  "flow": "announcement",
  "recipients": [
    {
      "email": "REPLACE BY YOUR EMAIL ID",
      "language_code": "en",
      "roles": [
        "recipient"
      ]
    }
  ],
  "sender": {
    "display_name": "Sender",
    "email": "[email protected]",
    "language_code": "en"
  },
  "subject": "Logo approval",
  "reply_to": {
    "email": "[email protected]",
    "name": "Question Department"
  },
  "attachments": [
    {
      "name": "Logo Approval Form.png",
      "content": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAIAAACQd1PeAAAADElEQVQIW2Pg/8IPAAIoAROapGHUAAAAAElFTkSuQmCC"
    }
  ]
}

Error

If one of the mandatory parameter value(s) is missing, you receive the following error:

{
  "error": "Missing field: recipients"
}