{"openapi":"3.0.0","info":{"description":"Email service"},"servers":[{"description":"Email service","url":"https://api.apirails.com/zohozeptomail"}],"paths":{"/v1.1/email":{"post":{"tags":["Email Sending"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.zoho.com/zeptomail/help/api/email-sending.html","api_endpoint":"https://api.zeptomail.com/v1.1/email"},"summary":"Send a transactional email","description":"Send a transactional email","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"from":{"type":"object","description":"Sender email address and name","required":true,"properties":{"address":{"type":"string","description":"Email address","required":true},"name":{"type":"string","description":"Display name"}}},"to":{"type":"array","description":"Recipient email addresses","required":true,"items":{"type":"object","properties":{"email_address":{"type":"object","description":"Email","required":true}}}},"cc":{"type":"array","description":"CC recipients","items":{"type":"object","properties":{"email_address":{"type":"object","description":"Email","required":true}}}},"bcc":{"type":"array","description":"BCC recipients","items":{"type":"object","properties":{"email_address":{"type":"object","description":"Email","required":true}}}},"reply_to":{"type":"array","description":"Reply-to addresses","items":{"type":"object","properties":{"email_address":{"type":"object","description":"Email","required":true}}}},"subject":{"type":"string","description":"Email subject","required":true},"htmlbody":{"type":"string","description":"HTML email body"},"textbody":{"type":"string","description":"Plain text email body"},"attachments":{"type":"array","description":"File attachments using file_cache_key","items":{"type":"object","properties":{"file_cache_key":{"type":"string","description":"File cache key from upload","required":true}}}},"inline_images":{"type":"array","description":"Inline images using file_cache_key","items":{"type":"object","properties":{"file_cache_key":{"type":"string","description":"File cache key","required":true},"cid":{"type":"string","description":"Content ID for referencing in HTML","required":true}}}},"track_clicks":{"type":"boolean","description":"Track link clicks","enum":[true,false]},"track_opens":{"type":"boolean","description":"Track email opens","enum":[true,false]},"client_reference":{"type":"string","description":"Custom reference ID for tracking"},"mime_headers":{"type":"object","description":"Custom MIME headers"}}},"example":{"from":[{"address":"accounts@info.zylker.com","name":"Paula"}],"to":[[{"email_address":{"address":"user@example.com","name":"Sara"}}]],"cc":[],"bcc":[],"reply_to":[],"subject":["Account Confirmation"],"htmlbody":["<div><b>Verify your account</b></div>"],"textbody":["Please verify your account."],"attachments":[],"inline_images":[],"track_clicks":"","track_opens":"","client_reference":["order_12345"],"mime_headers":[{"X-Custom":"value"}]}}}}},"get":{"tags":["Email Logs"],"parameters":[{"name":"mailagent_key","in":"query","description":"Agent key","required":false,"schema":{"type":"string","example":""}},{"name":"request_id","in":"query","description":"Request ID","required":false,"schema":{"type":"string","example":""}},{"name":"date_from","in":"query","description":"Start date (DD/MM/YYYY, hh:mm AM/PM)","required":false,"schema":{"type":"string","example":""}},{"name":"date_to","in":"query","description":"End date (DD/MM/YYYY, hh:mm AM/PM)","required":false,"schema":{"type":"string","example":""}},{"name":"from","in":"query","description":"Filter by FROM address","required":false,"schema":{"type":"string","example":""}},{"name":"to","in":"query","description":"Filter by recipient","required":false,"schema":{"type":"string","example":""}},{"name":"cc","in":"query","description":"Filter by CC","required":false,"schema":{"type":"string","example":""}},{"name":"bcc","in":"query","description":"Filter by BCC","required":false,"schema":{"type":"string","example":""}},{"name":"subject","in":"query","description":"Filter by subject","required":false,"schema":{"type":"string","example":""}},{"name":"client_reference","in":"query","description":"Filter by client reference","required":false,"schema":{"type":"string","example":""}},{"name":"is_hb","in":"query","description":"Filter hard bounced","required":false,"schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"is_sb","in":"query","description":"Filter soft bounced","required":false,"schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"is_delivered","in":"query","description":"Filter delivered","required":false,"schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"is_mailfailure","in":"query","description":"Filter process-failed","required":false,"schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"offset","in":"query","description":"Records to skip","required":false,"schema":{"type":"number","example":""}},{"name":"limit","in":"query","description":"Records to return","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.zoho.com/zeptomail/help/api/get-email-logs.html","api_endpoint":"https://api.zeptomail.com/v1.1/email"},"summary":"Get all email logs","description":"Get all email logs","security":[{"bearerAuth":[]}]}},"/v1.1/email/batch":{"post":{"tags":["Email Sending"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.zoho.com/zeptomail/help/api/batch-email-sending.html","api_endpoint":"https://api.zeptomail.com/v1.1/email/batch"},"summary":"Send a batch of transactional emails","description":"Send a batch of transactional emails","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"batch_id":{"type":"string","description":"Unique batch identifier"},"data":{"type":"array","description":"Array of email objects","required":true,"items":{"type":"object","properties":{"from":{"type":"object","description":"Sender","required":true},"to":{"type":"array","description":"Recipients","required":true},"subject":{"type":"string","description":"Subject","required":true},"htmlbody":{"type":"string","description":"HTML body"},"textbody":{"type":"string","description":"Text body"}}}},"track_clicks":{"type":"boolean","description":"Track link clicks","enum":[true,false]},"track_opens":{"type":"boolean","description":"Track email opens","enum":[true,false]},"client_reference":{"type":"string","description":"Custom reference ID"},"mime_headers":{"type":"object","description":"Custom MIME headers"}}},"example":{"batch_id":["batch_001"],"data":[[{"from":{"address":"sender@example.com"},"to":[{"email_address":{"address":"user@example.com"}}],"subject":"Welcome"}]],"track_clicks":"","track_opens":"","client_reference":["ref_001"],"mime_headers":{}}}}}}},"/v1.1/email/template":{"post":{"tags":["Templates"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.zoho.com/zeptomail/help/api/email-templates.html","api_endpoint":"https://api.zeptomail.com/v1.1/email/template"},"summary":"Send email using a template","description":"Send email using a template","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"mailagent_key":{"type":"string","description":"Agent alias for template lookup","required":true},"template_key":{"type":"string","description":"Template key to use","required":true},"from":{"type":"object","description":"Sender email address and name","required":true,"properties":{"address":{"type":"string","description":"Email address","required":true},"name":{"type":"string","description":"Display name"}}},"to":{"type":"array","description":"Recipients","required":true,"items":{"type":"object","properties":{"email_address":{"type":"object","description":"Email","required":true}}}},"cc":{"type":"array","description":"CC recipients","items":{"type":"object"}},"bcc":{"type":"array","description":"BCC recipients","items":{"type":"object"}},"reply_to":{"type":"array","description":"Reply-to addresses","items":{"type":"object"}},"subject":{"type":"string","description":"Email subject (overrides template)"},"attachments":{"type":"array","description":"File attachments","items":{"type":"object"}},"inline_images":{"type":"array","description":"Inline images","items":{"type":"object"}},"track_clicks":{"type":"boolean","description":"Track link clicks","enum":[true,false]},"track_opens":{"type":"boolean","description":"Track email opens","enum":[true,false]},"client_reference":{"type":"string","description":"Custom reference ID"},"merge_tags":{"type":"object","description":"Template variable substitution"}}},"example":{"mailagent_key":["ea36f19a.737a00c139129ee5"],"template_key":["welcome_template"],"from":{},"to":[],"cc":[],"bcc":[],"reply_to":[],"subject":["Welcome!"],"attachments":[],"inline_images":[],"track_clicks":"","track_opens":"","client_reference":"","merge_tags":[{"name":"John","email":"user@example.com"}]}}}}}},"/v1.1/email/template/batch":{"post":{"tags":["Templates"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.zoho.com/zeptomail/help/api/batch-email-templates.html","api_endpoint":"https://api.zeptomail.com/v1.1/email/template/batch"},"summary":"Send batch emails using a template","description":"Send batch emails using a template","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"mailagent_key":{"type":"string","description":"Agent alias for template lookup","required":true},"template_key":{"type":"string","description":"Template key to use","required":true},"data":{"type":"array","description":"Array of email objects with merge_tags","required":true,"items":{"type":"object","properties":{"from":{"type":"object","description":"Sender","required":true},"to":{"type":"array","description":"Recipients","required":true},"merge_tags":{"type":"object","description":"Template variables for this recipient"}}}},"track_clicks":{"type":"boolean","description":"Track link clicks","enum":[true,false]},"track_opens":{"type":"boolean","description":"Track email opens","enum":[true,false]},"client_reference":{"type":"string","description":"Custom reference ID"}}},"example":{"mailagent_key":["ea36f19a.737a00c139129ee5"],"template_key":["welcome_template"],"data":[[{"from":{"address":"sender@example.com"},"to":[{"email_address":{"address":"user@example.com"}}],"merge_tags":{"name":"John"}}]],"track_clicks":"","track_opens":"","client_reference":""}}}}}},"/v1.1/files":{"post":{"tags":["File Cache"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.zoho.com/zeptomail/help/api/file-cache-api.html","api_endpoint":"https://api.zeptomail.com/v1.1/files"},"summary":"Upload file to File Cache","description":"Upload file to File Cache","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"name":{"type":"string","description":"Name of the file","required":true},"binary":{"type":"string","format":"binary","description":"File content as binary data","required":true}}},"example":{"name":["logo.jpg"],"binary":["(binary file data)"]}}}}}},"/v1.1/agents/{agent_key}/templates":{"post":{"tags":["Templates Management"],"parameters":[{"name":"agent_key","in":"path","description":"Agent alias (mailagent key)","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.zoho.com/zeptomail/help/api/add-template.html","api_endpoint":"https://api.zeptomail.com/v1.1/agents/{agent_key}/templates"},"summary":"Add a new email template","description":"Add a new email template","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"template_name":{"type":"string","description":"Name of the template","required":true},"htmlbody":{"type":"string","description":"HTML content","required":true},"textbody":{"type":"string","description":"Plain text content"},"subject":{"type":"string","description":"Subject with template variables","required":true}}},"example":{"template_name":["Welcome Email"],"htmlbody":["<div>Hello {{name}}</div>"],"textbody":["Hello {{name}}"],"subject":["Welcome {{name}}!"]}}}}},"get":{"tags":["Templates Management"],"parameters":[{"name":"agent_key","in":"path","description":"Agent alias (mailagent key)","required":true,"schema":{"type":"string","example":""}},{"name":"limit","in":"query","description":"Number of templates to return","required":false,"schema":{"type":"number","example":""}},{"name":"offset","in":"query","description":"Starting position","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.zoho.com/zeptomail/help/api/list-template.html","api_endpoint":"https://api.zeptomail.com/v1.1/agents/{agent_key}/templates"},"summary":"List all email templates for an agent","description":"List all email templates for an agent","security":[{"bearerAuth":[]}]}},"/v1.1/agents/{agent_key}/templates/{template_key}":{"put":{"tags":["Templates Management"],"parameters":[{"name":"agent_key","in":"path","description":"Agent alias (mailagent key)","required":true,"schema":{"type":"string","example":""}},{"name":"template_key","in":"path","description":"Template key","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.zoho.com/zeptomail/help/api/update-template.html","api_endpoint":"https://api.zeptomail.com/v1.1/agents/{agent_key}/templates/{template_key}"},"summary":"Update an email template","description":"Update an email template","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"template_name":{"type":"string","description":"New template name"},"htmlbody":{"type":"string","description":"Updated HTML content"},"textbody":{"type":"string","description":"Updated plain text content"},"subject":{"type":"string","description":"Updated subject"}}},"example":{"template_name":["Updated Welcome"],"htmlbody":"","textbody":"","subject":""}}}}},"get":{"tags":["Templates Management"],"parameters":[{"name":"agent_key","in":"path","description":"Agent alias (mailagent key)","required":true,"schema":{"type":"string","example":""}},{"name":"template_key","in":"path","description":"Template key","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.zoho.com/zeptomail/help/api/get-template.html","api_endpoint":"https://api.zeptomail.com/v1.1/agents/{agent_key}/templates/{template_key}"},"summary":"Get a specific email template","description":"Get a specific email template","security":[{"bearerAuth":[]}]},"delete":{"tags":["Templates Management"],"parameters":[{"name":"agent_key","in":"path","description":"Agent alias (mailagent key)","required":true,"schema":{"type":"string","example":""}},{"name":"template_key","in":"path","description":"Template key","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.zoho.com/zeptomail/help/api/delete-template.html","api_endpoint":"https://api.zeptomail.com/v1.1/agents/{agent_key}/templates/{template_key}"},"summary":"Delete an email template","description":"Delete an email template","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1.1/suppressions/{zem_dnd_type}":{"post":{"tags":["Suppression"],"parameters":[{"name":"zem_dnd_type","in":"path","description":"Type of suppression — email or domain","required":true,"schema":{"type":"string","example":"","items":{"type":"string","enum":["email","domain"]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.zoho.com/zeptomail/help/api/add-suppression-list.html","api_endpoint":"https://api.zeptomail.com/v1.1/suppressions/{zem_dnd_type}"},"summary":"Add entries to suppression list","description":"Add entries to suppression list","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"values":{"type":"array","description":"Email addresses or domains to suppress","required":true,"items":{"type":"string"}},"action":{"type":"string","description":"Suppression action","enum":["reject","suppress","suppress_tracking"]},"mailagent_keys":{"type":"array","description":"Agent alias values to associate","items":{"type":"string"}},"description":{"type":"string","description":"Reason for suppression"}}},"example":{"values":[["user@example.com"]],"action":"","mailagent_keys":[["ea3.erf.te45rfb"]],"description":["User unsubscribed"]}}}}},"put":{"tags":["Suppression"],"parameters":[{"name":"zem_dnd_type","in":"path","description":"Type of suppression — email or domain","required":true,"schema":{"type":"string","example":"","items":{"type":"string","enum":["email","domain"]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.zoho.com/zeptomail/help/api/edit-suppression-list.html","api_endpoint":"https://api.zeptomail.com/v1.1/suppressions/{zem_dnd_type}"},"summary":"Edit suppression list entries","description":"Edit suppression list entries","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"values":{"type":"array","description":"Email addresses or domains to update","required":true,"items":{"type":"string"}},"action":{"type":"string","description":"Suppression action","enum":["reject","suppress","suppress_tracking"]},"mailagent_keys":{"type":"array","description":"Agent alias values","items":{"type":"string"}},"description":{"type":"string","description":"Reason"}}},"example":{"values":[["user@example.com"]],"action":"","mailagent_keys":[],"description":["Updated reason"]}}}}},"get":{"tags":["Suppression"],"parameters":[{"name":"zem_dnd_type","in":"path","description":"Type of suppression — email or domain","required":true,"schema":{"type":"string","example":"","items":{"type":"string","enum":["email","domain"]}}},{"name":"limit","in":"query","description":"Number of entries","required":false,"schema":{"type":"number","example":""}},{"name":"offset","in":"query","description":"Starting position","required":false,"schema":{"type":"number","example":""}},{"name":"mailagent_key","in":"query","description":"Agent alias to filter","required":false,"schema":{"type":"string","example":""}},{"name":"date_from","in":"query","description":"Start date (DD/MM/YYYY, hh:mm AM/PM)","required":false,"schema":{"type":"string","example":""}},{"name":"date_to","in":"query","description":"End date (DD/MM/YYYY, hh:mm AM/PM)","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.zoho.com/zeptomail/help/api/get-suppression-list.html","api_endpoint":"https://api.zeptomail.com/v1.1/suppressions/{zem_dnd_type}"},"summary":"Fetch suppression list entries","description":"Fetch suppression list entries","security":[{"bearerAuth":[]}]},"delete":{"tags":["Suppression"],"parameters":[{"name":"zem_dnd_type","in":"path","description":"Type of suppression — email or domain","required":true,"schema":{"type":"string","example":"","items":{"type":"string","enum":["email","domain"]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.zoho.com/zeptomail/help/api/delete-suppression-list.html","api_endpoint":"https://api.zeptomail.com/v1.1/suppressions/{zem_dnd_type}"},"summary":"Delete suppression list entries","description":"Delete suppression list entries","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"values":{"type":"array","description":"Email addresses or domains to remove","required":true,"items":{"type":"string"}}}},"example":{"values":[["user@example.com"]]}}}}}},"/v1.1/domains":{"post":{"tags":["Domains"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.zoho.com/zeptomail/help/api/add-domain.html","api_endpoint":"https://api.zeptomail.com/v1.1/domains"},"summary":"Add a new domain","description":"Add a new domain","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"domain_name":{"type":"string","description":"Domain name (max 100 chars)","required":true},"mailagent_keys":{"type":"array","description":"Agent alias(es) to associate","required":true,"items":{"type":"string"}},"sub_domain_prefix":{"type":"string","description":"Subdomain prefix for bounce capture (max 100 chars)","required":true}}},"example":{"domain_name":["zylker.com"],"mailagent_keys":[["5a57413991a0a232"]],"sub_domain_prefix":["bounce"]}}}}},"get":{"tags":["Domains"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.zoho.com/zeptomail/help/api/list-all-domains.html","api_endpoint":"https://api.zeptomail.com/v1.1/domains"},"summary":"List all domains","description":"List all domains","security":[{"bearerAuth":[]}]}},"/v1.1/domains/{domain_key}":{"put":{"tags":["Domains"],"parameters":[{"name":"domain_key","in":"path","description":"Domain identification key","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.zoho.com/zeptomail/help/api/edit-domain.html","api_endpoint":"https://api.zeptomail.com/v1.1/domains/{domain_key}"},"summary":"Edit an existing domain","description":"Edit an existing domain","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"new_domain":{"type":"string","description":"New domain name (max 100 chars)"},"new_sub_domain_prefix":{"type":"string","description":"New subdomain prefix (max 100 chars)"},"associate_mailagents":{"type":"array","description":"Agent(s) to associate","items":{"type":"string"}},"unassociate_mailagents":{"type":"array","description":"Agent(s) to disassociate","items":{"type":"string"}}}},"example":{"new_domain":["newdomain.com"],"new_sub_domain_prefix":["bounce2"],"associate_mailagents":[["agent_alias_1"]],"unassociate_mailagents":[["agent_alias_2"]]}}}}},"get":{"tags":["Domains"],"parameters":[{"name":"domain_key","in":"path","description":"Domain identification key","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.zoho.com/zeptomail/help/api/get-specific-domain.html","api_endpoint":"https://api.zeptomail.com/v1.1/domains/{domain_key}"},"summary":"Get a specific domain","description":"Get a specific domain","security":[{"bearerAuth":[]}]},"delete":{"tags":["Domains"],"parameters":[{"name":"domain_key","in":"path","description":"Domain identification key","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.zoho.com/zeptomail/help/api/delete-domain.html","api_endpoint":"https://api.zeptomail.com/v1.1/domains/{domain_key}"},"summary":"Delete a domain","description":"Delete a domain","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1.1/domains/{domain_key}/verify":{"put":{"tags":["Domains"],"parameters":[{"name":"domain_key","in":"path","description":"Domain identification key","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.zoho.com/zeptomail/help/api/verify-domain.html","api_endpoint":"https://api.zeptomail.com/v1.1/domains/{domain_key}/verify"},"summary":"Verify domain DNS configuration","description":"Verify domain DNS configuration","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1.1/agents":{"post":{"tags":["Agents"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.zoho.com/zeptomail/help/api/add-agent.html","api_endpoint":"https://api.zeptomail.com/v1.1/agents"},"summary":"Add a new mail agent","description":"Add a new mail agent","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"mailagent_name":{"type":"string","description":"Agent name (max 100 chars)","required":true},"description":{"type":"string","description":"Description"}}},"example":{"mailagent_name":["Notifications"],"description":["Used to send notification emails"]}}}}},"get":{"tags":["Agents"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.zoho.com/zeptomail/help/api/list-agents.html","api_endpoint":"https://api.zeptomail.com/v1.1/agents"},"summary":"List all agents","description":"List all agents","security":[{"bearerAuth":[]}]}},"/v1.1/agents/{agent_key}":{"put":{"tags":["Agents"],"parameters":[{"name":"agent_key","in":"path","description":"Agent alias","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.zoho.com/zeptomail/help/api/edit-agent.html","api_endpoint":"https://api.zeptomail.com/v1.1/agents/{agent_key}"},"summary":"Edit an existing agent","description":"Edit an existing agent","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"mailagent_name":{"type":"string","description":"New name (max 100 chars)","required":true},"description":{"type":"string","description":"Description"}}},"example":{"mailagent_name":["UpdatedNotifications"],"description":["Updated description"]}}}}}},"/v1.1/agents/{agent_key}/short-passwords":{"post":{"tags":["Agents"],"parameters":[{"name":"agent_key","in":"path","description":"Agent alias","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.zoho.com/zeptomail/help/api/generate-short-password.html","api_endpoint":"https://api.zeptomail.com/v1.1/agents/{agent_key}/short-passwords"},"summary":"Generate SMTP short password","description":"Generate SMTP short password","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"get":{"tags":["Agents"],"parameters":[{"name":"agent_key","in":"path","description":"Agent alias","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.zoho.com/zeptomail/help/api/list-short-passwords.html","api_endpoint":"https://api.zeptomail.com/v1.1/agents/{agent_key}/short-passwords"},"summary":"List SMTP short passwords","description":"List SMTP short passwords","security":[{"bearerAuth":[]}]}},"/v1.1/agents/{agent_key}/short-passwords/{id}":{"delete":{"tags":["Agents"],"parameters":[{"name":"agent_key","in":"path","description":"Agent alias","required":true,"schema":{"type":"string","example":""}},{"name":"id","in":"path","description":"Unique ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.zoho.com/zeptomail/help/api/delete-short-password.html","api_endpoint":"https://api.zeptomail.com/v1.1/agents/{agent_key}/short-passwords/{id}"},"summary":"Delete SMTP short password","description":"Delete SMTP short password","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1.1/agents/{agent_key}/apikeys":{"post":{"tags":["Agents"],"parameters":[{"name":"agent_key","in":"path","description":"Agent alias","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.zoho.com/zeptomail/help/api/generate-api-keys.html","api_endpoint":"https://api.zeptomail.com/v1.1/agents/{agent_key}/apikeys"},"summary":"Generate API key (send mail token)","description":"Generate API key (send mail token)","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"get":{"tags":["Agents"],"parameters":[{"name":"agent_key","in":"path","description":"Agent alias","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.zoho.com/zeptomail/help/api/list-api-keys.html","api_endpoint":"https://api.zeptomail.com/v1.1/agents/{agent_key}/apikeys"},"summary":"List API keys","description":"List API keys","security":[{"bearerAuth":[]}]}},"/v1.1/agents/{agent_key}/apikeys/{id}":{"delete":{"tags":["Agents"],"parameters":[{"name":"agent_key","in":"path","description":"Agent alias","required":true,"schema":{"type":"string","example":""}},{"name":"id","in":"path","description":"Unique ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.zoho.com/zeptomail/help/api/delete-api-key.html","api_endpoint":"https://api.zeptomail.com/v1.1/agents/{agent_key}/apikeys/{id}"},"summary":"Delete an API key","description":"Delete an API key","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1.1/email/email-reference/{email_reference}":{"get":{"tags":["Email Logs"],"parameters":[{"name":"email_reference","in":"path","description":"Message ID or request ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.zoho.com/zeptomail/help/api/get-specific-email-log.html","api_endpoint":"https://api.zeptomail.com/v1.1/email/email-reference/{email_reference}"},"summary":"Get a specific email log","description":"Get a specific email log","security":[{"bearerAuth":[]}]}},"/v1.1/{export_type}/exports":{"post":{"tags":["Export"],"parameters":[{"name":"export_type","in":"path","description":"Type of export","required":true,"schema":{"type":"string","example":"","items":{"type":"string","enum":["mail-logs","activity-logs","suppression-list"]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.zoho.com/zeptomail/help/api/export-logs.html","api_endpoint":"https://api.zeptomail.com/v1.1/{export_type}/exports"},"summary":"Export logs","description":"Export logs","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"date_from":{"type":"string","description":"Start date (DD/MM/YYYY, hh:mm AM/PM)"},"date_to":{"type":"string","description":"End date (DD/MM/YYYY, hh:mm AM/PM)"},"is_sb":{"type":"boolean","description":"Include soft bounce data (mail-logs)","enum":[true,false]},"is_hb":{"type":"boolean","description":"Include hard bounce data (mail-logs)","enum":[true,false]},"is_delivered":{"type":"boolean","description":"Include delivered data (mail-logs)","enum":[true,false]},"is_mailfailure":{"type":"boolean","description":"Include process-failed data (mail-logs)","enum":[true,false]},"mailagent_key":{"type":"string","description":"Agent alias (mail-logs)"},"from":{"type":"string","description":"Filter by sender (mail-logs)"},"to":{"type":"string","description":"Filter by recipient (mail-logs)"},"subject":{"type":"string","description":"Filter by subject (mail-logs)"},"client_reference":{"type":"string","description":"Filter by client ref (mail-logs)"},"password":{"type":"string","description":"Password-protect exported file"},"dndType":{"type":"string","description":"Suppression type (suppression-list export)","enum":["email","domain"]},"entity":{"type":"string","description":"Account section (activity-logs export)"},"modified_by":{"type":"string","description":"User (activity-logs export)"}}},"example":{"date_from":["19/02/2025, 01:00 AM"],"date_to":["19/02/2025, 01:00 AM"],"is_sb":"","is_hb":"","is_delivered":"","is_mailfailure":"","mailagent_key":["ea3.erf.te45rfb"],"from":["sender@example.com"],"to":"","subject":"","client_reference":"","password":["secret123"],"dndType":["email"],"entity":["Agent"],"modified_by":["Rebecca"]}}}}},"get":{"tags":["Export"],"parameters":[{"name":"export_type","in":"path","description":"Type of export","required":true,"schema":{"type":"string","example":"","items":{"type":"string","enum":["mail-logs","activity-logs","suppression-list"]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.zoho.com/zeptomail/help/api/fetch-exports.html","api_endpoint":"https://api.zeptomail.com/v1.1/{export_type}/exports"},"summary":"Fetch all exports","description":"Fetch all exports","security":[{"bearerAuth":[]}]},"delete":{"tags":["Export"],"parameters":[{"name":"export_type","in":"path","description":"Type of export","required":true,"schema":{"type":"string","example":"","items":{"type":"string","enum":["mail-logs","activity-logs","suppression-list"]}}},{"name":"export_ids","in":"query","description":"Comma-separated export IDs to delete","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.zoho.com/zeptomail/help/api/delete-exports.html","api_endpoint":"https://api.zeptomail.com/v1.1/{export_type}/exports"},"summary":"Delete exported files","description":"Delete exported files","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1.1/{export_type}/exports/{export_id}/download":{"get":{"tags":["Export"],"parameters":[{"name":"export_type","in":"path","description":"Type of export","required":true,"schema":{"type":"string","example":"","items":{"type":"string","enum":["mail-logs","activity-logs","suppression-list"]}}},{"name":"export_id","in":"path","description":"Unique export ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.zoho.com/zeptomail/help/api/download-exports.html","api_endpoint":"https://api.zeptomail.com/v1.1/{export_type}/exports/{export_id}/download"},"summary":"Download exported file","description":"Download exported file","security":[{"bearerAuth":[]}]}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"security":[{"bearerAuth":[]}]}