{"templateId":"markdown","sharedDataIds":{},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Using communication templates from the API","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":"using-communication-templates-from-the-api","__idx":0},"children":["Using communication templates from the API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once a communication template has been created and enabled through the admin UI, you reference it by its identifier in your API submission requests. The platform replaces the default system template with the custom one and resolves any variables declared in the template at send time."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For how to create and manage templates, see ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/admin/templates"},"children":["Communication templates"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"evinotice","__idx":1},"children":["EviNotice"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["EviNotice template parameters are set at the top level of the submit request body."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"template-parameters","__idx":2},"children":["Template parameters"]},{"$$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":"Parameter"},"children":["Parameter"]},{"$$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":["NotificationTemplate"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identifier of the enabled ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EviNotice:Email:Notification"]}," template to use for the recipient's notification email."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NotificationTemplateValues"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Key-value pairs supplying values for the user variables declared in the notification template."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OwnerNotificationTemplate"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identifier of the enabled ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EviNotice:Email:OwnerNotification"]}," template to use for the issuer's status notification email."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OwnerNotificationTemplateValues"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Key-value pairs supplying values for the user variables declared in the owner notification template."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"evinotice-example","__idx":3},"children":["EviNotice example"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"POST /v2/EviNotice/Submit HTTP/1.1\nHost: api.evicertia.com\nAuthorization: Basic <base64(username:password)>\nContent-Type: application/json\n\n{\n  \"Subject\": \"Your insurance policy update\",\n  \"Body\": \"Please review the attached update to your insurance policy.\",\n  \"RecipientAddress\": \"recipient@example.com\",\n  \"RecipientLegalName\": \"Jane Smith\",\n  \"IssuerLegalName\": \"Acme Insurance\",\n  \"CertificationLevel\": \"Advanced_EU\",\n  \"NotificationTemplate\": \"acme-notice-en\",\n  \"NotificationTemplateValues\": {\n    \"policyNumber\": \"POL-2025-00123\",\n    \"renewalDate\": \"2025-06-30\"\n  },\n  \"OwnerNotificationTemplate\": \"acme-owner-notice-en\",\n  \"OwnerNotificationTemplateValues\": {\n    \"policyNumber\": \"POL-2025-00123\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"affidavit-side-effects","__idx":4},"children":["Affidavit side effects"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NotificationTemplate"]}," is set and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CertificationLevel"]}," is not ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["None"]},", the platform automatically generates the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EviNoticeDispatched"]}," affidavit regardless of whether it was requested in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitKinds"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"templates-in-batch-sending","__idx":5},"children":["Templates in batch sending"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The EviNotice, EviMail, and EviSMS ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/apis/evinotice-api#batch-operations"},"children":["batch APIs"]}," accept ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OwnerNotificationTemplate"]}," on the batch ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PATCH"]}," request, applying the issuer status-notification template across the batch. The recipient-facing ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NotificationTemplate"]}," is ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["not"]}," a batch field — batch content is set with the batch ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Body"]}," endpoint (or, for EviSMS, the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Text"]}," field) rather than a recipient notification template."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"template-values-format","__idx":6},"children":["Template values format"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["*TemplateValues"]}," parameters accept a flat key-value object where each key matches a user variable declared in the template and each value is the string to substitute at send time."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"\"NotificationTemplateValues\": {\n  \"policyNumber\": \"POL-2025-00123\",\n  \"renewalDate\": \"2025-06-30\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Variable names must match exactly what was declared during template creation. Variables marked as required in the template must be supplied in every request that references that template."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related","__idx":7},"children":["Related"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/admin/templates"},"children":["Communication templates"]}," — how to create, manage, and get templates approved"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/apis/evinotice-api"},"children":["EviNotice API"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/dev/integration-patterns"},"children":["Integration workflows"]}]}]}]},"headings":[{"value":"Using communication templates from the API","id":"using-communication-templates-from-the-api","depth":1},{"value":"EviNotice","id":"evinotice","depth":2},{"value":"Template parameters","id":"template-parameters","depth":3},{"value":"EviNotice example","id":"evinotice-example","depth":3},{"value":"Affidavit side effects","id":"affidavit-side-effects","depth":3},{"value":"Templates in batch sending","id":"templates-in-batch-sending","depth":3},{"value":"Template values format","id":"template-values-format","depth":2},{"value":"Related","id":"related","depth":2}],"frontmatter":{"title":"Using communication templates from the API","description":"How to reference enabled communication templates in EviNotice API submissions.","layout":"doc","outline":"deep","keywords":["communication templates","template identifier","template values","evinotice api templates","namirial notify api"],"seo":{"title":"Using communication templates from the API"}},"lastModified":"2026-07-28T10:32:13.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/namirialnotify/dev/templates","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}