POST/secufilerCreate a transfer and initiate the multipart upload
Request body application/json
| Field | Type | Description |
|---|---|---|
| sender * | string (email) | Sender email address. |
| recipients * | string (email)[] | One or more recipient email addresses. |
| filename * | string | |
| filesize * | integer (int64) | Total size of the file in bytes. Used to compute |
| subject | string | Subject shown in the notification email. |
| message | string | Message body shown in the notification email. |
| nta7516 | boolean | Apply NTA 7516 (Dutch secure healthcare email) handling. Honoured only when the sender's domain is a SecuMailer customer certified for NTA 7516; forced to false otherwise. |
Example
{
"sender": "system@customer.example",
"recipients": [
"bob@partner.example"
],
"filename": "archive.zip",
"filesize": 10737418240
}Responses
- 201
Transfer created and multipart upload initiated.
- 400
Invalid or missing request parameters — e.g. missing sender/recipients/ filename/filesize, malformed email, unknown nonce/uploadId, or SecuFiler not activated for the customer.
- 401
Missing or invalid API key.
- 403
The sender's domain is not an eligible SecuMailer customer, or SecuFiler is not activated for it.
- 413
Requested
filesizeexceeds the 5 TiB maximum. - 500
Server-side failure.