{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-products/namirialnotify/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"EviMail","description":"Integration and usage documentation.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"evimail","__idx":0},"children":["EviMail"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["EviMail is the Namirial Notify service for sending certified emails. The recipient gets a normal email in their inbox, and Namirial Notify records evidence for each phase of the delivery so you can prove that the message was sent, delivered, and — when configured — opened, accepted, or rejected."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This page is the integration guide. For the REST contract, see the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/apis/evimail-api"},"children":["EviMail API reference"]},". For shared concepts and terminology used across services, see ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/user-guides/states-outcomes"},"children":["States and outcomes"]}," and ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/user-guides/evidences-affidavits"},"children":["Evidence and affidavits"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"when-to-use-evimail","__idx":1},"children":["When to use EviMail"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Pick EviMail when the certified content is the email message itself and your integration needs to prove that the message reached the recipient's mailbox. Pick a different service when:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You need recipients to access content inside a hosted notice and record their on-platform actions. Use ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/services/evinotice"},"children":["EviNotice"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You need to deliver to a phone via SMS or RCS. Use ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/services/evisms"},"children":["EviSMS"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You need an electronic signature workflow on a document. Use ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/services/evisign"},"children":["EviSign"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You need certified physical mail. Use ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/services/evipost"},"children":["EviPost"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A side-by-side comparison is on the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/services"},"children":["Services"]}," page."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-the-pieces-fit-together","__idx":2},"children":["How the pieces fit together"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["EviMail involves a small set of related concepts. Keep these distinct as you read the rest of the page."]},{"$$mdtype":"Tag","name":"Mermaid","attributes":{"data-language":"mermaid","diagramSource":"%%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#E4F2F2', 'primaryBorderColor': '#006660', 'primaryTextColor': '#0A1111', 'lineColor': '#047C76', 'secondaryColor': '#CDDBDB', 'tertiaryColor': '#f5fafa', 'edgeLabelBackground': '#f5fafa', 'transitionColor': '#047C76'}}}%%\nflowchart LR\n C[\"EviMail
communication\"] --> R[\"Recipient
(1 main + N CC)\"]\n C --> EVS[\"Events
(Ready, Dispatched, Sent, Delivered,
Read, Replied, Closed, Failed)\"]\n EVS --> EV[\"Evidence items
(state transitions + timestamps)\"]\n EV --> AFF[\"Affidavits
(PDFs signed by Namirial Notify)\"]\n EVS --> CB[\"Callbacks
(filtered by PushNotificationFilter)\"]\n CB --> YS[\"Your system
(HTTPS endpoint)\"]\n AFF -.->|\"via AffidavitPublished
callback or Query\"| YS\n","diagramHtml":"

via AffidavitPublished
callback or Query

EviMail
communication

Recipient
(1 main + N CC)

Events
(Ready, Dispatched, Sent, Delivered,
Read, Replied, Closed, Failed)

Evidence items
(state transitions + timestamps)

Affidavits
(PDFs signed by Namirial Notify)

Callbacks
(filtered by PushNotificationFilter)

Your system
(HTTPS endpoint)

"},"children":["%%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#E4F2F2', 'primaryBorderColor': '#006660', 'primaryTextColor': '#0A1111', 'lineColor': '#047C76', 'secondaryColor': '#CDDBDB', 'tertiaryColor': '#f5fafa', 'edgeLabelBackground': '#f5fafa', 'transitionColor': '#047C76'}}}%%\nflowchart LR\n C[\"EviMail
communication\"] --> R[\"Recipient
(1 main + N CC)\"]\n C --> EVS[\"Events
(Ready, Dispatched, Sent, Delivered,
Read, Replied, Closed, Failed)\"]\n EVS --> EV[\"Evidence items
(state transitions + timestamps)\"]\n EV --> AFF[\"Affidavits
(PDFs signed by Namirial Notify)\"]\n EVS --> CB[\"Callbacks
(filtered by PushNotificationFilter)\"]\n CB --> YS[\"Your system
(HTTPS endpoint)\"]\n AFF -.->|\"via AffidavitPublished
callback or Query\"| YS\n"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Communication"]}," — a single submission to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/EviMail/Submit"]},". Identified by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eviId"]}," (returned in the response) and, optionally, by your own ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LookupKey"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Recipient"]}," — one main recipient (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Recipient.EmailAddress"]},") and optional ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CarbonCopy[]"]}," addresses. Only the main recipient generates evidence events."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Event"]}," — a recorded fact during the lifecycle, such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sent"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Delivered"]},". Some events also drive state transitions."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["State"]}," — the current phase of the communication. See the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"#states-reference"},"children":["state table"]}," below."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Evidence item"]}," — the recorded data behind an event. The Query endpoint exposes evidence summaries; affidavits certify selected items."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Affidavit"]}," — a signed PDF that certifies one or more evidence items. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitKinds"]}," you choose at submit time control which affidavits are generated."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Callback"]}," — an HTTP POST that Namirial Notify sends to your ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PushNotificationUrl"]}," when an event matches the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PushNotificationFilter"]}," you configured."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-evimail-works","__idx":3},"children":["How EviMail works"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The diagram below shows the happy path. The state names match the values returned by the API (see ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/apis/evimail-api#states-and-outcomes"},"children":["API reference"]},")."]},{"$$mdtype":"Tag","name":"Mermaid","attributes":{"data-language":"mermaid","diagramSource":"%%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#E4F2F2', 'primaryBorderColor': '#006660', 'primaryTextColor': '#0A1111', 'lineColor': '#047C76', 'secondaryColor': '#CDDBDB', 'tertiaryColor': '#f5fafa', 'edgeLabelBackground': '#f5fafa', 'transitionColor': '#047C76'}}}%%\nflowchart TD\n A[\"POST /v1/EviMail/Submit\"] --> B[\"State: New
submission accepted\"]\n B --> C[\"State: Ready
validated + content certified\"]\n C --> D[\"State: Dispatched
sending requested\"]\n D --> E[\"State: Sent
accepted by recipient's mail server\"]\n E --> F[\"State: Delivered
delivery confirmation received\"]\n F -.->|optional| G[\"State: Read
recipient opened the message\"]\n F -.->|optional| H[\"State: Replied
recipient accepted or rejected\"]\n G -.->|optional| H\n F --> I[\"State: Closed
tracking ends, outcome assigned\"]\n G --> I\n H --> I\n","diagramHtml":"

optional

optional

optional

POST /v1/EviMail/Submit

State: New
submission accepted

State: Ready
validated + content certified

State: Dispatched
sending requested

State: Sent
accepted by recipient's mail server

State: Delivered
delivery confirmation received

State: Read
recipient opened the message

State: Replied
recipient accepted or rejected

State: Closed
tracking ends, outcome assigned

"},"children":["%%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#E4F2F2', 'primaryBorderColor': '#006660', 'primaryTextColor': '#0A1111', 'lineColor': '#047C76', 'secondaryColor': '#CDDBDB', 'tertiaryColor': '#f5fafa', 'edgeLabelBackground': '#f5fafa', 'transitionColor': '#047C76'}}}%%\nflowchart TD\n A[\"POST /v1/EviMail/Submit\"] --> B[\"State: New
submission accepted\"]\n B --> C[\"State: Ready
validated + content certified\"]\n C --> D[\"State: Dispatched
sending requested\"]\n D --> E[\"State: Sent
accepted by recipient's mail server\"]\n E --> F[\"State: Delivered
delivery confirmation received\"]\n F -.->|optional| G[\"State: Read
recipient opened the message\"]\n F -.->|optional| H[\"State: Replied
recipient accepted or rejected\"]\n G -.->|optional| H\n F --> I[\"State: Closed
tracking ends, outcome assigned\"]\n G --> I\n H --> I\n"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Read"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Replied"]}," are optional and only appear when configured (open tracking enabled, and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CommitmentOptions"]}," enabled for accept/reject). ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]}," is terminal."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a state model that includes the failure path, see:"]},{"$$mdtype":"Tag","name":"Mermaid","attributes":{"data-language":"mermaid","diagramSource":"%%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#E4F2F2', 'primaryBorderColor': '#006660', 'primaryTextColor': '#0A1111', 'lineColor': '#047C76', 'secondaryColor': '#CDDBDB', 'tertiaryColor': '#f5fafa', 'edgeLabelBackground': '#f5fafa', 'transitionColor': '#047C76'}}}%%\nstateDiagram-v2\n [*] --> New: Submit accepted\n New --> Ready: content certified\n Ready --> Dispatched: sending requested\n Dispatched --> Sent: accepted by recipient's mail server\n Dispatched --> Failed: send error (may retry)\n Sent --> Delivered: delivery confirmation\n Sent --> Failed: delivery error\n Delivered --> Read: recipient opens (when configured)\n Sent --> Replied: accepts/rejects without opening (when configured)\n Delivered --> Replied: accepts/rejects (when configured)\n Read --> Replied: accepts/rejects (when configured)\n Sent --> Closed\n Delivered --> Closed\n Read --> Closed\n Replied --> Closed\n Failed --> Closed\n Closed --> [*]\n","diagramHtml":"

Submit accepted

content certified

sending requested

accepted by recipient's mail server

send error (may retry)

delivery confirmation

delivery error

recipient opens (when configured)

accepts/rejects without opening (when configured)

accepts/rejects (when configured)

accepts/rejects (when configured)

New

Ready

Dispatched

Sent

Failed

Delivered

Read

Replied

Closed

"},"children":["%%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#E4F2F2', 'primaryBorderColor': '#006660', 'primaryTextColor': '#0A1111', 'lineColor': '#047C76', 'secondaryColor': '#CDDBDB', 'tertiaryColor': '#f5fafa', 'edgeLabelBackground': '#f5fafa', 'transitionColor': '#047C76'}}}%%\nstateDiagram-v2\n [*] --> New: Submit accepted\n New --> Ready: content certified\n Ready --> Dispatched: sending requested\n Dispatched --> Sent: accepted by recipient's mail server\n Dispatched --> Failed: send error (may retry)\n Sent --> Delivered: delivery confirmation\n Sent --> Failed: delivery error\n Delivered --> Read: recipient opens (when configured)\n Sent --> Replied: accepts/rejects without opening (when configured)\n Delivered --> Replied: accepts/rejects (when configured)\n Read --> Replied: accepts/rejects (when configured)\n Sent --> Closed\n Delivered --> Closed\n Read --> Closed\n Replied --> Closed\n Failed --> Closed\n Closed --> [*]\n"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Failed"]}," is not necessarily terminal. The platform may retry. Wait for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]}," (with a final ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Outcome"]},") before declaring the communication a permanent failure."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The diagram below combines the happy-path sequence with the callbacks and affidavits that fire at each step. Use it as a quick reference for what to expect at any given state."]},{"$$mdtype":"Tag","name":"Mermaid","attributes":{"data-language":"mermaid","diagramSource":"%%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#E4F2F2', 'primaryBorderColor': '#006660', 'primaryTextColor': '#0A1111', 'lineColor': '#047C76', 'secondaryColor': '#CDDBDB', 'tertiaryColor': '#f5fafa', 'edgeLabelBackground': '#f5fafa', 'transitionColor': '#047C76'}}}%%\nflowchart LR\n S([Submit]) --> N[\"New\"]\n N --> R[\"Ready
CB: Ready
AFF: Submitted\"]\n R --> D[\"Dispatched
CB: Dispatched\"]\n D --> SE[\"Sent
CB: Sent
AFF: TransmissionResult\"]\n SE --> DL[\"Delivered
CB: Delivered
AFF: DeliveryResult\"]\n DL -.->|optional| RD[\"Read
CB: Read
AFF: Read\"]\n DL -.->|optional| RP[\"Replied
CB: Replied
AFF: Committed\"]\n RD -.->|optional| RP\n DL --> CL[\"Closed
CB: Closed
AFF: Closed · Complete\"]\n RD --> CL\n RP --> CL\n","diagramHtml":"

optional

optional

optional

Submit

New

Ready
CB: Ready
AFF: Submitted

Dispatched
CB: Dispatched

Sent
CB: Sent
AFF: TransmissionResult

Delivered
CB: Delivered
AFF: DeliveryResult

Read
CB: Read
AFF: Read

Replied
CB: Replied
AFF: Committed

Closed
CB: Closed
AFF: Closed · Complete

"},"children":["%%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#E4F2F2', 'primaryBorderColor': '#006660', 'primaryTextColor': '#0A1111', 'lineColor': '#047C76', 'secondaryColor': '#CDDBDB', 'tertiaryColor': '#f5fafa', 'edgeLabelBackground': '#f5fafa', 'transitionColor': '#047C76'}}}%%\nflowchart LR\n S([Submit]) --> N[\"New\"]\n N --> R[\"Ready
CB: Ready
AFF: Submitted\"]\n R --> D[\"Dispatched
CB: Dispatched\"]\n D --> SE[\"Sent
CB: Sent
AFF: TransmissionResult\"]\n SE --> DL[\"Delivered
CB: Delivered
AFF: DeliveryResult\"]\n DL -.->|optional| RD[\"Read
CB: Read
AFF: Read\"]\n DL -.->|optional| RP[\"Replied
CB: Replied
AFF: Committed\"]\n RD -.->|optional| RP\n DL --> CL[\"Closed
CB: Closed
AFF: Closed · Complete\"]\n RD --> CL\n RP --> CL\n"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CB"]}," = callback delivered to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PushNotificationUrl"]}," (if that kind is in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PushNotificationFilter"]},"). ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AFF"]}," = affidavit generated (if that kind is in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitKinds"]},"). Both are opt-in — configure them at submit time or neither fires."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"submit-a-certified-email","__idx":4},"children":["Submit a certified email"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Only three fields are required: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Subject"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Body"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Recipient.EmailAddress"]},". Everything else is optional but operationally important."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Minimal valid request"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST \"https://api.evicertia.com/v1/EviMail/Submit\" \\\n -u \"$EVI_USER:$EVI_PASS\" \\\n -H \"Content-Type: application/json\" \\\n -H \"X-Evi-IdempotencyToken: 3f1a8b40-1f4a-4c2c-8f3a-cabf12a14b6c\" \\\n -d '{\n \"Subject\": \"Your certified policy update\",\n \"Body\": \"

Hello, please review the attached document.

\",\n \"Recipient\": {\n \"EmailAddress\": \"recipient@example.com\"\n }\n }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This is enough to get a certified email delivered and tracked. The platform uses account defaults for certification level, language, and all other settings. No callbacks, no affidavits beyond the defaults — useful for a first smoke-test."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Beyond the three required fields, every other field — including everything in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Options"]}," — is optional at the API level. When you omit one, the platform applies an account or site default (for example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Language"]}," follows your site's configured language). The web submission form pre-selects these defaults, which is why they can look mandatory in the portal — but the API only requires ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Subject"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Body"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Recipient.EmailAddress"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Full production request"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST \"https://api.evicertia.com/v1/EviMail/Submit\" \\\n -u \"$EVI_USER:$EVI_PASS\" \\\n -H \"Content-Type: application/json\" \\\n -H \"X-Evi-IdempotencyToken: 3f1a8b40-1f4a-4c2c-8f3a-cabf12a14b6c\" \\\n --data @evimail-submit.json\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["evimail-submit.json"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"Subject\": \"Your certified policy update\",\n \"Body\": \"

Hello, please review the attached document.

\",\n \"LookupKey\": \"ORDER-12345\",\n \"IssuerName\": \"Sender Corp.\",\n \"From\": \"sender@example.com\",\n \"ReplyTo\": \"reply@example.com\",\n \"Recipient\": {\n \"LegalName\": \"Acme Corp\",\n \"EmailAddress\": \"recipient@example.com\"\n },\n \"CarbonCopy\": [\n { \"Name\": \"QA Team\", \"EmailAddress\": \"qa@example.com\" }\n ],\n \"Attachments\": [\n {\n \"DisplayName\": \"Policy\",\n \"Filename\": \"policy.pdf\",\n \"MimeType\": \"application/pdf\",\n \"Data\": \"JVBERi0xLjQgZXhhbXBsZQ==\",\n \"Attributes\": [\n { \"Key\": \"IncludeOnAffidavits\", \"Value\": \"true\" }\n ]\n }\n ],\n \"Options\": {\n \"CertificationLevel\": \"Advanced_EU\",\n \"TimeToLive\": 1440,\n \"Language\": \"en\",\n \"AffidavitLanguage\": \"en\",\n \"AffidavitKinds\": [\"Submitted\", \"DeliveryResult\", \"Read\", \"Closed\"],\n \"PushNotificationUrl\": \"https://your-system.example.com/callbacks/evimail\",\n \"PushNotificationFilter\": [\"Sent\", \"Delivered\", \"Read\", \"Failed\", \"Closed\"],\n \"PushNotificationExtraData\": \"order-12345\",\n \"EvidenceAccessControlMethod\": \"Public\",\n \"OnlineRetentionPeriod\": 1\n }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["On success the response is:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"eviId\": \"87ffa214e7734bd59b8da8ef00fd80f8\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Persist both ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eviId"]}," and your ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LookupKey"]},". You need them to reconcile against Query results and to correlate incoming callbacks."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"useful-fields-you-should-configure","__idx":5},"children":["Useful fields you should configure"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LookupKey"]}]}," — string. Your correlation key for this communication. Passed back verbatim in every callback (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AdditionalData.LookupKey"]},") and filterable in Query via ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WithLookupKeys"]},". The platform does not enforce uniqueness — two submissions with the same ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LookupKey"]}," are both accepted — so enforce uniqueness within your domain. Avoid characters that require URL encoding (spaces, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["&"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["#"]},", etc.) if you intend to use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WithLookupKeys"]}," as a query parameter. Omitting this field makes reconciliation significantly harder."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IssuerName"]}]}," — string. The legal entity name declared as the sender of the certified communication. This value appears on the generated affidavit PDFs and on the Namirial Notify hosted evidence page. It is ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["not"]}," the same as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["From"]}," — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IssuerName"]}," is the legal record of who initiated the communication, while ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["From"]}," is the inbox sender address the recipient sees. Use the full registered legal name of the sending organization."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["From"]}]}," — email address string. The sender address displayed in the recipient's inbox. Your account is pre-configured with a set of permitted sender addresses. The most common error cases: a malformed or unregistered address returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400 Bad Request"]},"; using the account's own reserved default From address returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["403 Forbidden"]},". Confirm the permitted addresses with your Namirial Notify contact before going live — this is a common source of integration failures in pre-production."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ReplyTo"]}]}," — email address string. Sets the reply-to header on the delivered email. Affects only how the recipient's mail client handles a reply action; it plays no role in the evidence chain or certification. Omit it if recipients should not be able to reply."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Options.CertificationLevel"]}]}," — enum string. The legal framework and regional variant applied to this communication. Supported values include ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Standard"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Advanced"]},", and country-specific variants such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Standard_EU"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Advanced_EU"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Standard_CO"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Advanced_MX"]},". The set available to your account depends on your subscription — submitting an unsupported level returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400 Bad Request"]}," with a field-level error. Confirm available levels with your Namirial Notify contact."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Options.TimeToLive"]}]}," — integer, minutes. How long the platform tracks the communication before closing its lifecycle. When the TTL elapses, the final outcome is derived from the milestones recorded up to that point, such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Certified"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sent"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Delivered"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Read"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Failed"]},". TTL expiry does not itself mean failure; the outcome is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Failed"]}," only when a failure was recorded. If omitted, the account's default TTL is used."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Options.AffidavitKinds"]}]}," — array of enum strings. The affidavit types you want generated for this communication. Generation is asynchronous and fires at the lifecycle moment each type is tied to (see the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"#when-each-affidavit-is-generated"},"children":["affidavit table"]},"). An invalid or unsupported value returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]},". Choosing more kinds than you need increases storage and callback volume. See ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/user-guides/evidences-affidavits#evimail"},"children":["Evidence and affidavits"]}," for the full catalog and legal implications of each type."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Options.PushNotificationUrl"]}]}," — URL string. Your HTTPS endpoint to receive callbacks. Using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["http://"]}," instead of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://"]}," reduces the callback payload: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AdditionalData.XmissionDetails"]}," (on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sent"]}," callbacks) and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AdditionalData.Comments"]}," (on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Replied"]}," callbacks) are stripped from HTTP responses. The URL must be publicly reachable from the Namirial Notify infrastructure — localhost, private network, or VPN-only addresses will silently exhaust retries. See ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"#callbacks-and-what-you-receive"},"children":["Callbacks and what you receive"]}," for the full delivery contract."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Options.PushNotificationFilter"]}]}," — array of enum strings. The callback kinds you want delivered. Valid values: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Ready"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Dispatched"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sent"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Delivered"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Read"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Replied"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Failed"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitPublished"]},". Submitting an invalid or duplicate value returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400 Bad Request"]},". An empty array disables all callbacks. Subscribe only to the kinds you act on — each extra subscription multiplies retry traffic when your endpoint is unhealthy."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Options.PushNotificationExtraData"]}]}," — string. An arbitrary value set at submit time that is echoed verbatim in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AdditionalData.ExtraData"]}," on every callback for this communication. Use it to embed a routing key, tenant identifier, or your internal record ID so your callback handler can process the event without a separate lookup. Any string value is accepted; there is no structural format requirement."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Options.CommitmentOptions"]}]}," — enum string. Enables and configures the accept/reject interaction for the recipient. Without this field (or with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Disabled"]},"), the recipient never reaches ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Replied"]}," state. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Cannot be changed after submission."]}," See ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"#acceptreject-commitment-commitmentoptions"},"children":["Accept/reject commitment"]}," below for the full behavior and related fields."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Options.EvidenceAccessControlMethod"]}]}," — enum string. Controls how the recipient authenticates before accessing the Namirial Notify hosted evidence page. Behavior per value:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Public"]}," — no authentication required; anyone with the link can view the evidence page. Simplest recipient experience."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Challenge"]}," — sends the recipient a one-time authentication code via a secondary channel before granting access."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AutoChallenge"]}," — automatically selects the appropriate challenge method based on the recipient's registered profile."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Public"]}," for lowest friction; use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Challenge"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AutoChallenge"]}," for communications that contain sensitive content or require stronger access control."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Options.OnlineRetentionPeriod"]}]}," — integer, years. How long the communication record — evidence items, affidavits, and the hosted evidence page — remains accessible online through the Namirial Notify platform. After this period, the record may be archived or removed from online access. Note: this does not affect the legal validity of affidavit PDFs you have already downloaded — those are self-contained signed documents. Valid values depend on your account subscription; confirm with your Namirial Notify contact."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Options.Language"]}]}," — enum string. The language for the notification email sent to the recipient. Accepted values: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ca"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["de"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["en"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["es"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fr"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["it"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pt"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pt-BR"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ro"]},". Defaults to the account's configured language when omitted. This controls recipient-facing UI text, not the content of your ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Body"]}," field."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Options.AffidavitLanguage"]}]}," — enum string. The language of generated affidavit PDFs. Accepted values: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ca"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["de"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["en"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["es"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fr"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["it"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pt"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pt-BR"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ro"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["el"]},". Note ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["el"]}," (Greek) is available for affidavits but not for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Language"]},". Defaults to the account's configured affidavit language when omitted."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"idempotency","__idx":6},"children":["Idempotency"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Include the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-Evi-IdempotencyToken"]}," header on every Submit. Use a UUID and keep it across retries."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A replay that matches a cached ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["200 OK"]}," returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["202 Accepted"]}," with the original body."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A replay that arrives while the first request is still in flight returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["409 Conflict"]},". Back off briefly and resend the same token."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Responses ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["401"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["408"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["409"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["429"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["5xx"]}," are not cached; the next request with the same token is re-executed."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response also carries an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-Evi-IdempotencyStatus"]}," header with one of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["New"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Replay"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Conflict"]},", so your client can branch deterministically without parsing the body."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"acceptreject-commitment--commitmentoptions-","__idx":7},"children":["Accept/reject commitment (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CommitmentOptions"]},")"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Options.CommitmentOptions"]}," controls whether and how the recipient can accept or reject the certified communication. It accepts one of four values:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Effect"},"children":["Effect"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Disabled"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No commitment interaction. The recipient receives the email as normal. This is commonly disabled unless platform configuration sets another default."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Accept"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The recipient is shown an Accept button on the Namirial Notify hosted page."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Reject"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The recipient is shown a Reject button."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AcceptOrReject"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The recipient can choose to Accept or Reject."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When commitment is enabled, the email body includes a link to a hosted Namirial Notify page where the recipient takes the configured action. Their response transitions the communication to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Replied"]}," state with outcome ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Accepted"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Rejected"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Related fields you can combine with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CommitmentOptions"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Options.CommitmentCommentsAllowed"]}]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},"/",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]},") — when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},", the recipient can enter a free-text comment alongside their response. The comment is included in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Replied"]}," callback's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AdditionalData.Comments"]}," field (HTTPS endpoints only)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Options.RequireAcceptReason"]}]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Options.AcceptReasons"]}]}," — when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RequireAcceptReason"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},", the recipient must pick a reason from the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AcceptReasons"]}," list before accepting."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Options.RequireRejectReason"]}]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Options.RejectReasons"]}]}," — same pattern for rejection."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Accept/reject reason fields require ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CommitmentCommentsAllowed: true"]},". Accept-only reason fields are not valid with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CommitmentOptions: Reject"]},", and reject-only reason fields are not valid with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CommitmentOptions: Accept"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When the recipient completes the action, the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Replied"]}," callback fires with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AdditionalData.Kind"]}," identifying whether the action was an acceptance or rejection. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Committed"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CommittedAdvanced"]}," affidavit is generated at this point (if included in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitKinds"]},")."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CommitmentOptions"]}," cannot be changed after submission. If your use case requires acceptance or rejection, enable it at submit time."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-the-recipient-sees","__idx":8},"children":["What the recipient sees"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"standard-certified-email-no-commitment","__idx":9},"children":["Standard certified email (no commitment)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The recipient receives a normal email in their inbox. The email may include a banner or header indicating it is a certified communication (controlled by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Options.DeliveryAppearance"]},")."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["No action is required from the recipient. Namirial Notify records delivery evidence and, when open tracking is available and configured, records the open as a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Read"]}," event."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"certified-email-with-acceptreject-commitment","__idx":10},"children":["Certified email with accept/reject commitment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Options.CommitmentOptions"]}," is set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Accept"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Reject"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AcceptOrReject"]},", the email includes a link to a Namirial Notify hosted confirmation page. The recipient:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Receives the email in their inbox."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Clicks the link in the email to open the hosted page."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Reviews the content and selects the configured action (accept, reject, or both)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Optionally adds a comment (if ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CommitmentCommentsAllowed"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Submits. The platform records the response and moves the communication to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Replied"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The recipient's response is what generates the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Replied"]}," callback and the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Committed"]}," affidavit. If the recipient never clicks the link, the communication eventually reaches ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]}," without a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Replied"]}," state."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The hosted confirmation page is served and branded by Namirial Notify. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EvidenceAccessControlMethod"]}," you set at submit time controls how recipients authenticate before they can access the page."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"callbacks-and-what-you-receive","__idx":11},"children":["Callbacks and what you receive"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Namirial Notify pushes JSON over HTTP to your ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PushNotificationUrl"]}," whenever a state change matches the configured ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PushNotificationFilter"]},". Callbacks are per-communication and opt-in."]},{"$$mdtype":"Tag","name":"Mermaid","attributes":{"data-language":"mermaid","diagramSource":"%%{init: {'theme': 'base', 'themeVariables': {'actorBkg': '#E4F2F2', 'actorBorder': '#006660', 'actorTextColor': '#0A1111', 'actorLineColor': '#047C76', 'signalColor': '#047C76', 'signalTextColor': '#0A1111', 'noteBkgColor': '#CDDBDB', 'noteTextColor': '#0A1111', 'noteBorderColor': '#006660', 'activationBkgColor': '#CDDBDB', 'activationBorderColor': '#006660', 'labelBoxBkgColor': '#E4F2F2', 'labelBoxBorderColor': '#006660', 'labelTextColor': '#0A1111', 'loopTextColor': '#0A1111'}}}%%\nsequenceDiagram\n participant N as Namirial Notify\n participant Y as Your callback endpoint\n Note over N: state transition fires\n N->>N: filter check (PushNotificationFilter ∋ Kind?)\n N->>Y: POST PushNotificationUrl (JSON, no auth header)\n alt 2xx within timeout\n Y-->>N: 200 OK\n Note over N: callback delivery acknowledged\n else error or timeout\n Y-->>N: timeout or non-2xx\n Note over N: retry after a configured delay\n N->>Y: POST again (same Identifier)\n end\n","diagramHtml":"
Your callback endpointNamirial NotifyYour callback endpointNamirial Notifystate transition firescallback delivery acknowledgedretry after a configured delayalt[2xx within timeout][error or timeout]filter check (PushNotificationFilter ∋ Kind?)POST PushNotificationUrl (JSON, no auth header)200 OKtimeout or non-2xxPOST again (same Identifier)
"},"children":["%%{init: {'theme': 'base', 'themeVariables': {'actorBkg': '#E4F2F2', 'actorBorder': '#006660', 'actorTextColor': '#0A1111', 'actorLineColor': '#047C76', 'signalColor': '#047C76', 'signalTextColor': '#0A1111', 'noteBkgColor': '#CDDBDB', 'noteTextColor': '#0A1111', 'noteBorderColor': '#006660', 'activationBkgColor': '#CDDBDB', 'activationBorderColor': '#006660', 'labelBoxBkgColor': '#E4F2F2', 'labelBoxBorderColor': '#006660', 'labelTextColor': '#0A1111', 'loopTextColor': '#0A1111'}}}%%\nsequenceDiagram\n participant N as Namirial Notify\n participant Y as Your callback endpoint\n Note over N: state transition fires\n N->>N: filter check (PushNotificationFilter ∋ Kind?)\n N->>Y: POST PushNotificationUrl (JSON, no auth header)\n alt 2xx within timeout\n Y-->>N: 200 OK\n Note over N: callback delivery acknowledged\n else error or timeout\n Y-->>N: timeout or non-2xx\n Note over N: retry after a configured delay\n N->>Y: POST again (same Identifier)\n end\n"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every callback shares the same envelope:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"Identifier\": \"1234\",\n \"Kind\": \"Sent\",\n \"Date\": \"2026-01-22T12:46:32.4830752+01:00\",\n \"EvidenceId\": \"2aca3ea149f943879726a87000c1f704\",\n \"EvidenceType\": \"eviMail\",\n \"Site\": \"my-site\",\n \"Owner\": null,\n \"OwnerEmail\": \"sender@example.com\",\n \"AdditionalData\": {\n \"From\": \"sender@example.com\",\n \"To\": \"recipient@example.com\",\n \"Subject\": \"Your certified policy update\",\n \"LookupKey\": \"ORDER-12345\",\n \"State\": \"Sent\",\n \"CreationDate\": \"2026-01-22T12:46:12.3113880+01:00\",\n \"XmissionDetails\": \"Successfully sent to recipient's mail server.\",\n \"ExtraData\": \"order-12345\"\n }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Identifier"]}," as the idempotency key on your side. The shared ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/dev/callbacks"},"children":["Callbacks and webhooks"]}," page documents the full payload structure, retry behavior, and per-service field tables."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["HTTPS unlocks extra detail."]}," The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["XmissionDetails"]}," field on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sent"]}," callbacks and the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Comments"]}," field on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Replied"]}," callbacks are only included when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PushNotificationUrl"]}," uses HTTPS."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"securing-your-callback-endpoint","__idx":12},"children":["Securing your callback endpoint"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Namirial Notify sends callbacks as plain HTTP POST requests with no authentication header — there is nothing in the request itself that proves it came from the platform. Apply layered defenses on your endpoint:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use HTTPS."]}," Required for the full payload and for any endpoint handling certified evidence data. HTTP endpoints are accepted by the API but should only be used during local development."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Restrict by IP."]}," Allowlist only the egress IP ranges used by the Namirial Notify callback infrastructure at your network or load-balancer layer. Requests from any other source are dropped before they reach your application. Obtain the current IP range list from your Namirial Notify contact — ranges can change, so subscribe to update notifications if your contact provides them."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Validate the payload before acting on it."]}," On every incoming callback, check:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EvidenceType"]}," equals ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"eviMail\""]}," — reject anything else silently."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EvidenceId"]}," matches a communication you submitted — cross-reference against your own records and discard unknown IDs."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Kind"]}," is one of the values you subscribed to in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PushNotificationFilter"]}," — anything outside that set is unexpected."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Log and discard any callback that fails these checks. Do not update business state based on a callback you cannot corroborate."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Keep the URL low-profile."]}," Treat ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PushNotificationUrl"]}," as a secret: do not publish it in client-side code, documentation, or unredacted logs. If you suspect it has been exposed, set a new URL on future submissions — the URL is fixed at submit time and cannot be changed for in-flight communications, so rotate promptly and monitor existing open communications until they close."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Respond quickly with a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2xx"]},"."]}," Return the status code before doing any heavy processing, and handle the work in a background queue. A slow response risks a timeout-triggered retry, which multiplies traffic on your endpoint and may create duplicate processing if your handler is not idempotent."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"additional-callback-payload-examples","__idx":13},"children":["Additional callback payload examples"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Delivered"]}," — delivery confirmation received"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"Identifier\": \"2345\",\n \"Kind\": \"Delivered\",\n \"Date\": \"2026-01-22T12:47:05.0000000+01:00\",\n \"EvidenceId\": \"87ffa214e7734bd59b8da8ef00fd80f8\",\n \"EvidenceType\": \"eviMail\",\n \"Site\": \"my-site\",\n \"Owner\": null,\n \"OwnerEmail\": \"sender@example.com\",\n \"AdditionalData\": {\n \"From\": \"sender@example.com\",\n \"To\": \"recipient@example.com\",\n \"Subject\": \"Your certified policy update\",\n \"LookupKey\": \"ORDER-12345\",\n \"State\": \"Delivered\",\n \"CreationDate\": \"2026-01-22T12:46:12.3113880+01:00\",\n \"Progress\": \"Confirmation of message delivery\",\n \"Description\": \"The message or the notification with the link were delivered to the final recipient, but the content still has not been opened/read.\",\n \"ExtraData\": \"order-12345\"\n }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Delivered"]}," state or callback confirms a delivery milestone but does not close the lifecycle. Wait for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]},", then inspect ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Outcome"]}," for the final result. If requested, the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DeliveryResult"]}," affidavit records the delivery result; use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DeliveredOn"]}," and the event details, not the affidavit kind alone, to confirm success."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Read"]}," — recipient opened the message (open tracking enabled)"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"Identifier\": \"3456\",\n \"Kind\": \"Read\",\n \"Date\": \"2026-01-22T13:15:42.0000000+01:00\",\n \"EvidenceId\": \"87ffa214e7734bd59b8da8ef00fd80f8\",\n \"EvidenceType\": \"eviMail\",\n \"Site\": \"my-site\",\n \"Owner\": null,\n \"OwnerEmail\": \"sender@example.com\",\n \"AdditionalData\": {\n \"From\": \"sender@example.com\",\n \"To\": \"recipient@example.com\",\n \"Subject\": \"Your certified policy update\",\n \"LookupKey\": \"ORDER-12345\",\n \"State\": \"Read\",\n \"CreationDate\": \"2026-01-22T12:46:12.3113880+01:00\",\n \"Progress\": \"Notification of opening or reading of the message\",\n \"Description\": \"The message has been opened or read by the final recipient.\",\n \"ExtraData\": \"order-12345\"\n }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Open tracking is best-effort. Deduplicate on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Identifier"]}," — the same open event can fire more than once if the recipient opens the message multiple times. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Read"]}," affidavit is generated only once."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Failed"]}," — delivery attempt failed"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"Identifier\": \"4567\",\n \"Kind\": \"Failed\",\n \"Date\": \"2026-01-22T12:51:00.0000000+01:00\",\n \"EvidenceId\": \"c3d4e5f601234bd59b8da8ef00fd80f8\",\n \"EvidenceType\": \"eviMail\",\n \"Site\": \"my-site\",\n \"Owner\": null,\n \"OwnerEmail\": \"sender@example.com\",\n \"AdditionalData\": {\n \"From\": \"sender@example.com\",\n \"To\": \"recipient@example.com\",\n \"Subject\": \"Your certified policy update\",\n \"LookupKey\": \"ORDER-99999\",\n \"State\": \"Failed\",\n \"CreationDate\": \"2026-01-22T12:46:12.3113880+01:00\",\n \"Progress\": \"There was an error that precludes normal processing of the message.\",\n \"Description\": \"An unrecoverable error occurred or the retry limit has been reached, making it impossible to send the message.\",\n \"ExtraData\": \"order-99999\"\n }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Failed"]}," is not terminal on its own — the platform may retry. Do not resubmit. Wait for the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]}," callback and check ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AdditionalData.Outcome"]},". Permanent failure is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Outcome: Failed"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Replied"]}," — recipient accepted (HTTPS endpoint, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CommitmentOptions"]}," enabled)"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"Identifier\": \"5678\",\n \"Kind\": \"Replied\",\n \"Date\": \"2026-01-22T14:23:10.0000000+01:00\",\n \"EvidenceId\": \"87ffa214e7734bd59b8da8ef00fd80f8\",\n \"EvidenceType\": \"eviMail\",\n \"Site\": \"my-site\",\n \"Owner\": null,\n \"OwnerEmail\": \"sender@example.com\",\n \"AdditionalData\": {\n \"From\": \"sender@example.com\",\n \"To\": \"recipient@example.com\",\n \"Subject\": \"Your certified policy update\",\n \"LookupKey\": \"ORDER-12345\",\n \"State\": \"Replied\",\n \"CreationDate\": \"2026-01-22T12:46:12.3113880+01:00\",\n \"Kind\": \"Accepted\",\n \"Comments\": \"I agree with the terms and conditions.\",\n \"ExtraData\": \"order-12345\"\n }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AdditionalData.Kind"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Accepted"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Rejected"]}," — branch on this to determine the recipient's commitment decision. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Comments"]}," is only present when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PushNotificationUrl"]}," uses HTTPS and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CommitmentCommentsAllowed"]}," was ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]}," — lifecycle ended, outcome assigned"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"Identifier\": \"9012\",\n \"Kind\": \"Closed\",\n \"Date\": \"2026-01-22T14:25:00.0000000+01:00\",\n \"EvidenceId\": \"87ffa214e7734bd59b8da8ef00fd80f8\",\n \"EvidenceType\": \"eviMail\",\n \"Site\": \"my-site\",\n \"Owner\": null,\n \"OwnerEmail\": \"sender@example.com\",\n \"AdditionalData\": {\n \"From\": \"sender@example.com\",\n \"To\": \"recipient@example.com\",\n \"Subject\": \"Your certified policy update\",\n \"LookupKey\": \"ORDER-12345\",\n \"State\": \"Closed\",\n \"CreationDate\": \"2026-01-22T12:46:12.3113880+01:00\",\n \"Outcome\": \"Accepted\",\n \"OutcomeDescription\": \"The communication was accepted by the recipient.\",\n \"ExtraData\": \"order-12345\"\n }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]}," is the terminal event. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AdditionalData.Outcome"]}," holds the final result — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Delivered"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Accepted"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Rejected"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Failed"]},", etc. Always wait for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]}," before marking a transaction complete on your side."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitPublished"]}," — an affidavit has been generated and is ready to download"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"Identifier\": \"6789\",\n \"Kind\": \"AffidavitPublished\",\n \"Date\": \"2026-01-22T12:48:30.0000000+01:00\",\n \"EvidenceId\": \"87ffa214e7734bd59b8da8ef00fd80f8\",\n \"EvidenceType\": \"eviMail\",\n \"Site\": \"my-site\",\n \"Owner\": null,\n \"OwnerEmail\": \"sender@example.com\",\n \"AdditionalData\": {\n \"From\": \"sender@example.com\",\n \"To\": \"recipient@example.com\",\n \"Subject\": \"Your certified policy update\",\n \"LookupKey\": \"ORDER-12345\",\n \"State\": \"Delivered\",\n \"CreationDate\": \"2026-01-22T12:46:12.3113880+01:00\",\n \"AffidavitId\": \"a1b2c3d4e5f641239726a87000c1f704\",\n \"AffidavitKind\": \"DeliveryResult\",\n \"AffidavitName\": \"Certification of delivery\",\n \"ExtraData\": \"order-12345\"\n }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["One ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitPublished"]}," callback fires per generated affidavit. Persist ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AdditionalData.AffidavitId"]}," — it is the key for downloading the PDF from the API. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AdditionalData.AffidavitKind"]}," tells you which lifecycle moment the affidavit covers (see the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"#when-each-affidavit-is-generated"},"children":["affidavit table"]},"). For on-demand affidavits requested via ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/EviMail/AffidavitRequest"]},", the callback also includes ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AdditionalData.RequestId"]}," so you can correlate it with your original request. If the affidavit was regenerated, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AdditionalData.Regenerated"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"what-each-callback-means","__idx":14},"children":["What each callback means"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"style":{"minWidth":"140px"}},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Kind"]}]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"When it fires"},"children":["When it fires"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Final business outcome?"},"children":["Final business outcome?"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Affidavit-bearing?"},"children":["Affidavit-bearing?"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Extra fields in AdditionalData"},"children":["Extra fields in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AdditionalData"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What you should do"},"children":["What you should do"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Ready"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["After admission and content certification"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Indirect (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Submitted"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SubmittedAdvanced"]},")"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional internal \"queued\" → \"processed\" transition"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Dispatched"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["After sending is requested and the message is ready for the sender component"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Progress"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Description"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Update tracking"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sent"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["After the recipient's mail server accepts the message"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TransmissionResult"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["XmissionDetails"]}," (HTTPS only)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Update tracking; do not retry on your side"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Delivered"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["After delivery confirmation is received"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DeliveryResult"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Progress"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Description"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Treat as confirmed delivery"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["After open is detected"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Progress"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Description"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Open tracking is best-effort. Deduplicate on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Identifier"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Replied"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["After the recipient accepts or rejects (when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CommitmentOptions"]}," enabled)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No (the decision is recorded, but the lifecycle may remain open)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Committed"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CommittedAdvanced"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Kind"]}," (accept / reject), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Comments"]}," (HTTPS only)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Branch on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AdditionalData.Kind"]},"; persist ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Comments"]}," when present; wait for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["When tracking ends"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Complete"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Failed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Outcome"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OutcomeDescription"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Mark the transaction terminal"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Failed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["On send or delivery failure"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No (terminal failure is signaled by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Outcome: Failed"]},")"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Failed"]}," (when terminal)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Progress"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Description"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Do not resubmit; wait for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitPublished"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Each time an affidavit is published (per-event or on-demand)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The affidavit itself"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitId"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitKind"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitName"]},"; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RequestId"]}," if on-demand; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Regenerated"]}," if true"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Download the affidavit by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitId"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"additionaldata-fields-by-event","__idx":15},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AdditionalData"]}," fields by event"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All callbacks share a common set of fields. Some fields only appear on specific event types or under specific conditions."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Fields present in every callback"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["From"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sender address as configured on Submit"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["To"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Main recipient address"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Subject"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Email subject"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LookupKey"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your correlation key (omitted if not set on Submit)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["State"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Current communication state at the time of the callback"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CreationDate"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ISO 8601"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Timestamp when the communication was first submitted"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ExtraData"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Verbatim copy of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PushNotificationExtraData"]}," from Submit (omitted if not set)"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Event-specific fields"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Present on"},"children":["Present on"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Condition"},"children":["Condition"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["XmissionDetails"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sent"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["HTTPS endpoint only"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Human-readable summary of the SMTP handoff result"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Progress"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Dispatched"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Delivered"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Read"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Failed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Always"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Human-readable string describing the current processing stage"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Description"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Dispatched"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Delivered"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Read"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Failed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Always"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Human-readable description of the event outcome"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Kind"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Replied"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Always"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Accepted"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Rejected"]}," — the recipient's commitment decision"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Comments"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Replied"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["HTTPS endpoint + ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CommitmentCommentsAllowed: true"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Free-text comment entered by the recipient"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Outcome"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Always"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Final outcome: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Delivered"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Accepted"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Rejected"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Failed"]},", etc."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OutcomeDescription"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Always"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Human-readable description of the final outcome"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitPublished"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Always"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unique identifier of the generated affidavit — use this to download the PDF"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitKind"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitPublished"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Always"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Which affidavit type was generated (e.g. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DeliveryResult"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Committed"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitPublished"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Always"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Display name of the affidavit document"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RequestId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitPublished"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["On-demand affidavits only"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Correlates the callback to the original ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitRequest"]}," call"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Regenerated"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitPublished"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Only when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Present and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}," when this affidavit replaced a previously generated one"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"states-reference","__idx":16},"children":["States reference"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Query endpoint and callbacks both expose the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["State"]}," value. Use this table to interpret it."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Display name"},"children":["Display name"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Technical name"},"children":["Technical name"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"When it occurs"},"children":["When it occurs"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Final?"},"children":["Final?"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Callback repeatable?"},"children":["Callback repeatable?"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Related callback"},"children":["Related callback"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Affidavit implication"},"children":["Affidavit implication"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What you should do"},"children":["What you should do"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Draft"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Draft"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Saved in UI but not submitted"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Not visible via API"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["New"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["New"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Submit accepted; admission and content certification begin"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Submitted"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SubmittedAdvanced"]}," once certified"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Store ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eviId"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LookupKey"]}," for reconciliation"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ready"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Ready"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Validated, certified, and ready for sending"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Ready"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional UI transition"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Dispatched"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Dispatched"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sending has been requested; the message is ready for the sender component"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Dispatched"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Update tracking; not yet sent or delivered"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sent"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sent"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Recipient's mail server accepted the message"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sent"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TransmissionResult"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Reconcile against your in-flight set"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Delivered"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Delivered"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Delivery confirmation was received"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Delivered"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DeliveryResult"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Surface \"delivered\" to the operator"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Recipient opened the message (when supported)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Yes"]}," — fires on each open; deduplicate on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Identifier"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Read"]}," (generated once regardless)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Treat as best-effort; deduplicate on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Identifier"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Replied"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Replied"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Recipient accepted or rejected (when configured)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Replied"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Committed"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CommittedAdvanced"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Branch on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Kind"]}," from the callback"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Closed"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tracking ended; outcome assigned"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ClosedAdvanced"]},", often ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Complete"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CompleteAdvanced"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Mark the transaction terminal"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Failed"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Failed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Delivery failure occurred; retries may still follow"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Yes"]}," — fires on each retry attempt"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Failed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Failed"]}," (when terminal)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Wait for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]}," before declaring permanent failure"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Unknown"]}," is enum padding for forward compatibility; treat it as \"unmapped\" and rely on the recorded timestamps."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For outcomes (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["None"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Certified"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sent"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Delivered"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Read"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Accepted"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Rejected"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Failed"]},"), see the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/apis/evimail-api#states-and-outcomes"},"children":["API reference"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"evidence-and-affidavits","__idx":17},"children":["Evidence and affidavits"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["EviMail records evidence for relevant lifecycle and technical events, and the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitKinds"]}," you set at submit time control which of those items get certified into signed PDF affidavits. The full catalog and formal definitions are in ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/user-guides/evidences-affidavits#evimail"},"children":["Evidence and affidavits"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"when-each-affidavit-is-generated","__idx":18},"children":["When each affidavit is generated"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The table below maps the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitKinds"]}," values to the lifecycle moment that triggers generation. All values are optional and configured at submit time except ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OnDemand"]},", which is triggered on request."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"AffidavitKinds value"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitKinds"]}," value"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Triggered at"},"children":["Triggered at"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Notes"},"children":["Notes"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"AffidavitPublished callback fires?"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitPublished"]}," callback fires?"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Submitted"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["New → Ready"]}," (content certified)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Certifies admission, content, and metadata"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes, if in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PushNotificationFilter"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SubmittedAdvanced"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["New → Ready"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Advanced variant; includes rendered body"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TransmissionResult"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sent"]}," (SMTP response received)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Certifies the handoff to the recipient mail server"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DeliveryResult"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Delivered"]}," (delivery confirmation/result received)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Certifies the delivery result"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Read"]}," (recipient opened the message)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Only generated once, even if open is detected multiple times"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Committed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Replied"]}," (recipient accepted or rejected)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Certifies the acceptance or rejection action"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CommittedAdvanced"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Replied"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Advanced variant of the commitment affidavit"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Certifies the end of tracking"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ClosedAdvanced"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Advanced variant"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Complete"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Certifies the full chain from submission to closure, regardless of final result"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CompleteAdvanced"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Advanced variant of the complete lifecycle affidavit, regardless of final result"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OnDemand"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["On request via ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/EviMail/AffidavitRequest"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Requires ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OnDemand"]}," in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitKinds"]}," at submit time and an eligible, non-closed communication"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes, with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RequestId"]}," in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AdditionalData"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Event"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Technical events when generated by the configured affidavit kinds"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Internal technical record for events that do not have a more specific affidavit kind"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Failed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]}," following terminal failure"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Only when the final outcome is failure"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Key things to know:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Every generated affidavit fires an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitPublished"]}," callback to the original ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PushNotificationUrl"]},", but only if ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitPublished"]}," is in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PushNotificationFilter"]},". The callback includes ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitId"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitKind"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitName"]}," in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AdditionalData"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Affidavit generation is ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["asynchronous"]},". The affidavit is not available instantly after the state transition — wait for the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitPublished"]}," callback or poll with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IncludeAffidavits=true"]}," on Query."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["To enable on-demand affidavits, include ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OnDemand"]}," in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitKinds"]}," at submit time. This ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["cannot be enabled retroactively"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["On-demand affidavit requests are rejected when the communication is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Draft"]},", already ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]},", not enabled for on-demand affidavits, over the configured maximum request count, or requested by a non-owner."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You can also retrieve affidavit metadata via the Query endpoint without subscribing to callbacks."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OnDemand"]}," was included in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitKinds"]}," at submit time and the communication is still eligible, you can request an additional affidavit later with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/EviMail/AffidavitRequest"]}," (see the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/apis/evimail-api#request-an-on-demand-affidavit"},"children":["API reference"]},"). The generation is asynchronous; you receive an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitPublished"]}," callback when it is ready."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"querying-status","__idx":19},"children":["Querying status"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the Query endpoint as a fallback when callbacks lag, when you need a point-in-time snapshot, or for batch reconciliation. The most common filters:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WithUniqueIds="]}," — fetch one or more communications by id."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WithLookupKeys="]}," — fetch by your correlation key."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OnState=Closed"]}," — fetch only closed communications."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WithOutcome=Delivered"]}," — fetch by final outcome."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IncludeAffidavits=true"]}," — include affidavit metadata in results."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://api.evicertia.com/v1/EviMail/Query?WithLookupKeys=ORDER-12345&IncludeAffidavits=true\" \\\n -u \"$EVI_USER:$EVI_PASS\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Response:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"totalMatches\": 1,\n \"results\": [\n {\n \"uniqueId\": \"87ffa214e7734bd59b8da8ef00fd80f8\",\n \"lookupKey\": \"ORDER-12345\",\n \"state\": \"Closed\",\n \"outcome\": \"Delivered\",\n \"creationDate\": \"2026-01-22T12:46:12.3113880Z\",\n \"sentOn\": \"2026-01-22T12:46:32.4830752Z\",\n \"deliveredOn\": \"2026-01-22T12:47:05.1023400Z\",\n \"affidavits\": [\n { \"uniqueId\": \"…\", \"kind\": \"Submitted\", \"name\": \"Certification of admission\" },\n { \"uniqueId\": \"…\", \"kind\": \"DeliveryResult\", \"name\": \"Certification of delivery\" },\n { \"uniqueId\": \"…\", \"kind\": \"Closed\", \"name\": \"Certification of closure\" }\n ]\n }\n ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For the full filter and response schema, see the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/apis/evimail-api#query-certified-emails"},"children":["API reference"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"first-call-walkthrough","__idx":20},"children":["First-call walkthrough"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Run through these steps before wiring EviMail into production. The goal is to confirm that the full round-trip — submit, receive callbacks, verify state, and download an affidavit — works end-to-end from your system."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"what-you-need","__idx":21},"children":["What you need"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API credentials"]}," — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EVI_USER"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EVI_PASS"]}," for your account. Obtain them from your Namirial Notify contact. Keep them out of source control."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["A recipient address you control"]}," — use a personal or team inbox so you can observe what the recipient receives and verify delivery."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["An HTTPS endpoint for callbacks"]}," (optional for the smoke-test, required to receive ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["XmissionDetails"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Comments"]},") — the URL must be reachable from the public internet. If you do not have one yet, use a webhook inspection tool or a local tunnel to expose a port on your machine temporarily."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-1--send-your-first-communication","__idx":22},"children":["Step 1 — Send your first communication"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Submit a minimal request using a recipient address you control. Generate a fresh UUID for the idempotency token each time you submit a new communication."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST \"https://api.evicertia.com/v1/EviMail/Submit\" \\\n -u \"$EVI_USER:$EVI_PASS\" \\\n -H \"Content-Type: application/json\" \\\n -H \"X-Evi-IdempotencyToken: 3f1a8b40-1f4a-4c2c-8f3a-cabf12a14b6c\" \\\n -d '{\n \"Subject\": \"Test certified email\",\n \"Body\": \"

This is a test from EviMail integration.

\",\n \"LookupKey\": \"TEST-001\",\n \"Recipient\": {\n \"EmailAddress\": \"your-inbox@example.com\"\n },\n \"Options\": {\n \"AffidavitKinds\": [\"Complete\"],\n \"PushNotificationUrl\": \"https://your-endpoint.example.com/callbacks/evimail\",\n \"PushNotificationFilter\": [\"Sent\", \"Delivered\", \"Closed\", \"AffidavitPublished\"]\n }\n }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Expected response:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{ \"eviId\": \"87ffa214e7734bd59b8da8ef00fd80f8\" }\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Save ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eviId"]},". If you get ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]},", check ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["responseStatus.errors[]"]}," for the failing field. If you get ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["401"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["403"]},", confirm credentials and that your account is provisioned for EviMail."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-2--verify-the-state-progresses","__idx":23},"children":["Step 2 — Verify the state progresses"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Query the communication a few seconds after submitting to confirm it has moved out of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["New"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl \"https://api.evicertia.com/v1/EviMail/Query?WithLookupKeys=TEST-001\" \\\n -u \"$EVI_USER:$EVI_PASS\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You should see ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"state\": \"Dispatched\""]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"state\": \"Sent\""]}," within seconds. If still ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"state\": \"New\""]},", wait and retry — the platform is still processing admission. If it stays in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["New"]}," for more than a minute, contact support."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-3--confirm-delivery","__idx":24},"children":["Step 3 — Confirm delivery"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you configured a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PushNotificationUrl"]},", check your endpoint logs as the communication progresses. You should receive ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Kind: Sent"]}," and eventually ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Kind: Closed"]},". If the delivery infrastructure reports a delivery signal, you also receive ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Kind: Delivered"]},". Because callbacks are independent messages and can arrive out of order, use their timestamps and query the transaction before making irreversible decisions."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you did not configure a callback URL, poll Query every 10–30 seconds until ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"state\": \"Closed\""]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl \"https://api.evicertia.com/v1/EviMail/Query?WithLookupKeys=TEST-001\" \\\n -u \"$EVI_USER:$EVI_PASS\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]},", check ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"outcome\""]},". If delivery confirmation was received, the expected outcome is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"Delivered\""]},"; otherwise, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"Sent\""]}," can be final even if the email arrived. Also check ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"deliveredOn\""]}," and your inbox."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-4--download-the-affidavit","__idx":25},"children":["Step 4 — Download the affidavit"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Because you included ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Complete"]}," in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitKinds"]},", an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitPublished"]}," callback fires when the affidavit is ready. Query with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IncludeAffidavits=true"]}," to get the affidavit metadata:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl \"https://api.evicertia.com/v1/EviMail/Query?WithLookupKeys=TEST-001&IncludeAffidavits=true\" \\\n -u \"$EVI_USER:$EVI_PASS\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Look for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["affidavits[]"]}," in the response. Use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["uniqueId"]}," of the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Complete"]}," affidavit to download the PDF via the Affidavit endpoint (see the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/apis/evimail-api"},"children":["API reference"]},"). Open it and confirm it is signed and shows the recorded lifecycle timestamps. A delivery timestamp is present only when delivery confirmation was recorded."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-5--test-the-failure-path","__idx":26},"children":["Step 5 — Test the failure path"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Resubmit using an address that will fail delivery — confirm this address with your Namirial Notify contact. Verify that:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The communication eventually reaches ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"state\": \"Closed\""]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"outcome\": \"Failed\""]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You receive both ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Kind: Failed"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Kind: Closed"]}," callbacks. They can be retried or arrive out of order, so reconcile them with Query."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your system handles ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Outcome: Failed"]}," without triggering an automatic resubmit."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This exercises your error-handling code before any real communications go through."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"integration-checklist","__idx":27},"children":["Integration checklist"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LookupKey"]}," on every Submit and persist ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eviId"]}," from the response."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Send ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-Evi-IdempotencyToken"]}," (UUIDv4) on every Submit. Treat ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["202 Accepted"]}," as success and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["409 Conflict"]}," as \"retry with the same token after a short backoff\"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use HTTPS for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PushNotificationUrl"]}," so you receive ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["XmissionDetails"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Comments"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Subscribe only to the callback kinds you act on. Each extra subscription multiplies retry traffic when your endpoint hiccups."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Make your callback handler idempotent, keyed on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Identifier"]},". The platform retries on non-2xx and on timeouts."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Store the raw callback body before parsing. This is invaluable for audit and for debugging shape drift."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use Query as a fallback when callbacks lag. Filter by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LookupKey"]}," and use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IncludeAffidavits=true"]}," when you need affidavit metadata."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Include ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OnDemand"]}," in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitKinds"]}," at submit time if you intend to call ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitRequest"]}," later. This cannot be added retroactively."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Persist ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitId"]}," from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitPublished"]}," callbacks. Affidavits are the legal artifact you will need during disputes."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Validate ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PushNotificationFilter"]}," values at submit time. Unsupported or repeated values are rejected by the API, so catch typos before submitting."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Test the happy path and the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Failed"]}," → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Outcome: Failed"]},") path in pre-production before going live."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"troubleshooting","__idx":28},"children":["Troubleshooting"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Symptom"},"children":["Symptom"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Likely causes"},"children":["Likely causes"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What to check"},"children":["What to check"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What to do"},"children":["What to do"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No callbacks received"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PushNotificationUrl"]}," missing on Submit; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PushNotificationFilter"]}," omits the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Kind"]}," you expect; endpoint returned non-2xx and retries exhausted; firewall blocks Namirial Notify egress"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Events via Query; server access logs for the callback ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Identifier"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Confirm filter and URL; make endpoint publicly reachable; use Query polling as fallback"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Message stays in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Dispatched"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sent"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sender processing still pending; recipient MTA slow or greylisting; mailbox full"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Timestamps in Query response: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dispatchedOn"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sentOn"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deliveredOn"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Wait for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]},"; do not resubmit"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deliveredOn"]}," is missing but ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["readOn"]}," is present"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deliveredOn"]}," depends on a DSN from the recipient's mail server, which many servers never send; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["readOn"]}," is recorded independently from supported open or read signals"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Both timestamps in the Query response"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["This is expected — an open or read was recorded even though no delivery notification arrived. Treat the message as delivered. See ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/user-guides/states-outcomes#why-delivery-and-read-tracking-can-be-incomplete"},"children":["Why delivery and read tracking can be incomplete"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Recipient says they did not get the email"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Spam filter; recipient address typo; alias forwarding broke"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Delivered"]}," callback and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deliveredOn"]}," timestamp; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["XmissionDetails"]}," on the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sent"]}," callback (HTTPS only)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Confirm the address; ask recipient to check spam; if address is wrong, correct and resubmit with a new idempotency token"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Duplicate callbacks"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Endpoint timed out or returned non-2xx; platform retried"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Identifier"]}," field — duplicates share the same value"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Deduplicate on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Identifier"]},"; make the callback handler idempotent"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Affidavit not available"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Generation is asynchronous; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitPublished"]}," has not fired yet; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OnDemand"]}," was not included in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitKinds"]}," at submit (on-demand requests blocked)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Query with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IncludeAffidavits=true"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Wait for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitPublished"]}," callback; for on-demand, if ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RequestId"]}," was returned but no callback arrived, contact support with that ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RequestId"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Submit → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400 Bad Request"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Missing required field (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Subject"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Body"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Recipient.EmailAddress"]},"); invalid or unsupported enum value (e.g. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CertificationLevel"]}," not on account); attachment too large"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["responseStatus.errors[]"]}," for field-level details"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fix the flagged field; retry with a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["new"]}," idempotency token"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Submit → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["401 Unauthorized"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Wrong environment base URL; credentials rotated"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization"]}," header value; confirm target environment"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Re-issue credentials through your Namirial Notify contact"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Submit → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["403 Forbidden"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Account not provisioned for EviMail; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["From"]}," address not permitted; restricted header in request"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["responseStatus.message"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contact your Namirial Notify account manager"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Submit → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["409 Conflict"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Another Submit with the same ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-Evi-IdempotencyToken"]}," is still in flight"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Back off briefly; retry with the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["same"]}," token; do not generate a new one"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Callback payload missing expected fields"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Subscribed to a different ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Kind"]}," than the one you are reading; field is HTTPS-only and URL is HTTP; mis-routing on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Kind"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Kind"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EvidenceType"]}," on the incoming payload"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Route on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Kind"]}," + ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EvidenceType"]}," first; switch ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PushNotificationUrl"]}," to HTTPS to unlock ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["XmissionDetails"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Comments"]},"; see ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/dev/callbacks"},"children":["Callbacks and webhooks"]}," for full field tables"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related","__idx":29},"children":["Related"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/services"},"children":["Services"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/services/evinotice"},"children":["EviNotice"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/services/evisms"},"children":["EviSMS"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/services/evipost"},"children":["EviPost"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/apis/evimail-api"},"children":["EviMail API reference"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/dev/callbacks"},"children":["Callbacks and webhooks"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/dev/security-best-practices"},"children":["Security and authentication"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/user-guides/states-outcomes"},"children":["States and outcomes"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/user-guides/states-outcomes#evimail-evidence-lifecycle"},"children":["EviMail evidence lifecycle"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/user-guides/evidences-affidavits"},"children":["Evidence and affidavits"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/dev/error-handling"},"children":["Error handling"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/issuer/create-evimail"},"children":["How to create a new EviMail (issuer UI)"]}]}]}]},"headings":[{"value":"EviMail","id":"evimail","depth":1},{"value":"When to use EviMail","id":"when-to-use-evimail","depth":2},{"value":"How the pieces fit together","id":"how-the-pieces-fit-together","depth":2},{"value":"How EviMail works","id":"how-evimail-works","depth":2},{"value":"Submit a certified email","id":"submit-a-certified-email","depth":2},{"value":"Useful fields you should configure","id":"useful-fields-you-should-configure","depth":3},{"value":"Idempotency","id":"idempotency","depth":3},{"value":"Accept/reject commitment ( CommitmentOptions )","id":"acceptreject-commitment--commitmentoptions-","depth":3},{"value":"What the recipient sees","id":"what-the-recipient-sees","depth":2},{"value":"Standard certified email (no commitment)","id":"standard-certified-email-no-commitment","depth":3},{"value":"Certified email with accept/reject commitment","id":"certified-email-with-acceptreject-commitment","depth":3},{"value":"Callbacks and what you receive","id":"callbacks-and-what-you-receive","depth":2},{"value":"Securing your callback endpoint","id":"securing-your-callback-endpoint","depth":3},{"value":"Additional callback payload examples","id":"additional-callback-payload-examples","depth":3},{"value":"What each callback means","id":"what-each-callback-means","depth":3},{"value":"AdditionalData fields by event","id":"additionaldata-fields-by-event","depth":3},{"value":"States reference","id":"states-reference","depth":2},{"value":"Evidence and affidavits","id":"evidence-and-affidavits","depth":2},{"value":"When each affidavit is generated","id":"when-each-affidavit-is-generated","depth":3},{"value":"Querying status","id":"querying-status","depth":2},{"value":"First-call walkthrough","id":"first-call-walkthrough","depth":2},{"value":"What you need","id":"what-you-need","depth":3},{"value":"Step 1 — Send your first communication","id":"step-1--send-your-first-communication","depth":3},{"value":"Step 2 — Verify the state progresses","id":"step-2--verify-the-state-progresses","depth":3},{"value":"Step 3 — Confirm delivery","id":"step-3--confirm-delivery","depth":3},{"value":"Step 4 — Download the affidavit","id":"step-4--download-the-affidavit","depth":3},{"value":"Step 5 — Test the failure path","id":"step-5--test-the-failure-path","depth":3},{"value":"Integration checklist","id":"integration-checklist","depth":2},{"value":"Troubleshooting","id":"troubleshooting","depth":2},{"value":"Related","id":"related","depth":2}],"frontmatter":{"title":"EviMail","description":"Practical integration guide to EviMail — submit certified emails, interpret states and callbacks, and download affidavits.","layout":"doc","outline":"deep","keywords":["evimail","certified email","email evidence","affidavit","delivery evidence","acceptance rejection","namirial notify","integration guide"],"seo":{"title":"EviMail"}},"lastModified":"2026-08-03T09:35:33.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/namirialnotify/services/evimail","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}