← Back to docs

GDPR Tooling

Built-in tools for GDPR compliance and data subject rights

Menu

Data Portability (Account Export)

Under GDPR Article 20, individuals have the right to receive their personal data in a portable format. EuroMail provides an API endpoint to export all data associated with your account:

curl https://api.euromail.dev/v1/account/export \
  -H "Authorization: Bearer em_live_..."

The response is one JSON document, {"exported_at": ..., "data": {...}}, sent as it is read, so large accounts download without a size limit. A download that stops reading for 60 seconds is cut off; request the export again. You can request one export per hour. data has these keys, each an array of every row the account owns unless noted:

KeyContents
accountThe account itself (an object)
team_membersTeam members and pending invitations
api_keysAPI keys: name, prefix, scopes, last use
domains, managed_subdomainsSending domains and their DNS records
streamsSending streams
templates, template_versionsTemplates and every saved version
webhooks, webhook_deliveriesWebhook endpoints and the delivery log
emails, tracking_linksEvery sent email still held, with body while it is retained, and the tracked links in each
email_recipient_deliveries, email_eventsPer-recipient delivery state and events
operationsBatch operations
suppressions, unsubscribe_eventsAll suppressions and unsubscribes
recipient_engagement, soft_bouncesPer-recipient engagement and soft-bounce counters
contact_lists, contacts, contact_imports, contact_import_rowsLists, contacts, imports and their rows
signup_forms, newslettersSignup forms and newsletters
inbound_routes, inbound_emails, inbound_delivery_attemptsInbound routing, received email and refused deliveries
agent_mailboxes, mailbox_messagesAgent mailboxes and their messages
dmarc_reports, dmarc_report_records, tls_rpt_reports, fbl_reportsReceived reports and their records
daily_email_stats, domain_daily_statsDaily statistics
insightsWeekly insights
feedback_asksFeedback questions sent to you
feedback_responses, feedback_written_on_other_accountsFeedback written in the dashboard on this account, and what this login wrote as a teammate on other accounts
overage_billing_records, signup_attributionOverage usage and how the account signed up
audit_logsThe whole audit log

Left out: the password hash, two-factor secret, API key hashes, webhook signing secrets, the DKIM private key and one-time tokens, and internal abuse and reputation signals. Attachments of mailbox messages are listed in mailbox_messages and downloaded per message. Sub-accounts are exported with their own API key.

Right to Erasure (Account Deletion)

GDPR Article 17 grants individuals the right to have their personal data deleted. You can delete a whole euromail account in the dashboard under Settings > Delete this account, which asks for the account's email address and the owner's password, or over the API:

curl -X DELETE https://api.euromail.dev/v1/account \
  -H "Authorization: Bearer em_live_..." \
  -H "X-Confirm-Delete: DELETE"

The account stops sending immediately and the data is erased seven days later. The response says the date. Until then the deletion can be cancelled, in the dashboard or with:

curl -X POST https://api.euromail.dev/v1/account/restore \
  -H "Authorization: Bearer em_live_..."

The erasure removes the account and everything belonging to it: domains, templates, email metadata, delivery logs, tracking events, contacts, suppression entries, API keys, and any sub-accounts. After the seven days it is irreversible. Emails already delivered to recipients' mail servers cannot be recalled; the erasure covers the data held at euromail. Invoices are kept for seven years, as Finnish accounting law requires.

Per-Email Data Export

In addition to full account exports, EuroMail supports exporting all data associated with a specific email address. This is useful when handling data subject access requests (DSAR) for individual recipients:

curl "https://api.euromail.dev/v1/gdpr/[email protected]" \
  -H "Authorization: Bearer em_live_..."

The response includes email metadata (without bodies), delivery events, tracking tokens, suppression entries, unsubscribe events, inbound emails, agent mailbox messages, engagement stats, webhook delivery logs, ISP feedback-loop (complaint) reports, and any matching entries in the delivery retry queue, for the specified address — matched anywhere it can appear as a recipient (the to address, a cc/bcc entry, or a reply-to address), not only as the primary recipient. This endpoint is rate limited to 1 request per minute per account.

Per-Email Data Erasure

To erase all data associated with a specific email address without deleting the entire account, use the per-email erasure endpoint:

curl -X DELETE "https://api.euromail.dev/v1/gdpr/[email protected]" \
  -H "Authorization: Bearer em_live_..."

This permanently deletes every category listed under Per-Email Data Export above — emails naming the address as the envelope recipient (with their associated delivery events and tracking tokens), suppression entries, unsubscribe events, contact list memberships, inbound emails, agent mailbox messages, engagement stats, webhook delivery logs, ISP feedback-loop reports, and matching entries in the delivery retry queue. An email where the address appears only as a cc, bcc or reply-to — not the primary recipient — has the address stripped from those fields instead of the email being deleted, since deleting it would remove a different recipient's delivery record. The action is logged in the audit trail — with the address stored masked, not in plaintext — and cannot be undone. This endpoint is rate limited to 1 request per minute per account.

Attachment Deletion

Attachments that arrive in agent mailboxes live in object storage, apart from the message itself. When a message is deleted, its attachments go with it. That holds however the message is deleted: you delete it yourself, an erasure request covers its sender or recipient, or the whole account is deleted. The attachment deletion is queued in the same step as the message delete and retried until object storage confirms it. An outage delays the deletion but does not lose it. A daily check also cleans up attachments left over from messages deleted before this was in place.

If you run euromail yourself, the worker only deletes attachments when ATTACHMENT_S3_ENVIRONMENT is set. Each bucket holds an object called .euromail-environment with the name of the deployment it belongs to. The first worker to delete from a bucket writes that object. After that, a worker configured with a different name deletes nothing from the bucket. This keeps a staging worker running on a copy of the production database from erasing production's attachments. Give each deployment its own name, such as production and staging, and point the other ATTACHMENT_S3_* settings (endpoint, bucket, region and keys) at that deployment's own bucket.

Audit Logging

Every action performed through the API or dashboard is recorded in the audit log with the following details:

FieldDescription
timestampWhen the action occurred (UTC)
userAPI key identifier or dashboard user who performed the action
actionWhat was done (e.g., email.sent, domain.created, suppression.deleted)
ip_addressSource IP address of the request
resourceThe affected resource identifier
detailsAdditional context about the action

Audit logs are accessible through the API and dashboard. They are retained for the duration of the data retention period and cannot be modified or deleted.

curl https://api.euromail.dev/v1/audit-logs?limit=50 \
  -H "Authorization: Bearer em_live_..."

Data Retention

EuroMail handles data retention automatically. Daily jobs remove each kind of data on its own schedule:

DataKept for
Email body content (HTML and text)30 days
Email delivery record (recipient, subject, headers)Up to 7 months
Tracked links (open, click and unsubscribe)180 days, never longer than the delivery record. After that, click links stop redirecting
Email events (opens, clicks, bounces, deliveries)90 days
Inbound email30 days
Agent mailbox messagesUntil you delete them
Webhook delivery logs180 days; copies of received email inside them are removed after 30 days
Spam complaint reportsThe provider's full report is removed after 30 days; the complaint itself stays
Unsubscribe recordsThe IP address and browser details are removed after 90 days; the opt-out itself stays
Per-recipient engagement countsRemoved after 210 days with no send, open or click
Audit logs365 days

Suppression list entries are kept regardless of these periods, so an address that bounced or complained is never mailed again. The GDPR page in the dashboard shows the periods for your account and whether any purge is still catching up.

Data Processing Agreement

A Data Processing Agreement (DPA) compliant with GDPR Article 28 is included with all EuroMail plans. The DPA covers the categories of data processed, processing purposes, subprocessor disclosures, including their locations and safeguards, security measures, and breach notification procedures. Download the current DPA from euromail.dev/legal/dpa/.

Processing Records

EuroMail maintains records of processing activities as required by GDPR Article 30. These records document the types of personal data processed (email addresses, message metadata, IP addresses), the purposes of processing (transactional email delivery), and the technical and organizational security measures in place. You can request a copy of the processing records for your account at any time through the dashboard or by contacting support.

Send your first email in about 90 seconds

The free tier includes 3,000 emails a month. Email storage and AI processing in Finland, with a DPA on every plan.

Create free account See live delivery data