{"openapi":"3.0.0","info":{"description":"Email service","version":[{"name":"v1","value":"v1"}]},"servers":[{"description":"Email service","url":"https://api.apirails.com/mailersend"}],"paths":{"/v1/email":{"post":{"tags":["Emails"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/email.html#send-an-email","api_endpoint":"https://api.mailersend.com/v1/email"},"summary":"Send an email","description":"Send an asynchronous email","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"text":{"type":"string","description":"Email represented in a text (text/plain) format"},"attachments":{"type":"array","description":"Array of attachment objects with filename and content (base64 encoded)","items":{"type":"string"}},"bcc":{"type":"array","description":"Array of BCC recipient objects","items":{"type":"string"}},"cc":{"type":"array","description":"Array of CC recipient objects","items":{"type":"string"}},"from":{"type":"object","description":"Not required if template_id is present and template has default sender set","properties":{}},"headers":{"type":"object","description":"Custom headers (this feature is available to Enterprise accounts only)","properties":{}},"html":{"type":"string","description":"Email represented in HTML (text/html) format"},"in_reply_to":{"type":"string","description":"Alphanumeric which can contain _, -, @ and ."},"personalization":{"type":"array","description":"Allows using personalization in {{var}} syntax","items":{"type":"string"}},"precedence_bulk":{"type":"boolean","description":"This parameter will override domain's advanced settings","enum":[true,false]},"reply_to":{"type":"object","description":"Reply to email address and name","properties":{}},"send_at":{"type":"number","description":"Has to be a Unix timestamp"},"settings":{"type":"object","description":"Email settings","properties":{}},"subject":{"type":"string","description":"Not required if template_id is present and template has default subject set"},"tags":{"type":"array","description":"Array of tags (limit is max 5 tags)","items":{"type":"string"}},"template_id":{"type":"string","description":"Template ID to use for the email"},"to":{"type":"array","description":"Array of recipient objects","required":true,"items":{"type":"string"}}}},"example":{"text":"","attachments":[{"content":"","disposition":"attachment","filename":"","id":""}],"bcc":[{"email":"","name":""}],"cc":[{"email":"","name":""}],"from":{"email":"","name":""},"headers":{},"html":"","in_reply_to":"","personalization":[{"data":{},"email":""}],"precedence_bulk":"","reply_to":{"email":"","name":""},"send_at":"","settings":{"bypass_bounce_management":false,"bypass_list_management":false,"bypass_spam_management":false,"bypass_unsubscribe_management":false,"track_clicks":true,"track_content":true,"track_opens":true,"track_unsubscribe":true,"track_unsubscribe_html":true,"track_unsubscribe_text":true},"subject":"","tags":[],"template_id":"","to":[{"email":"","name":""}]}}}}}},"/v1/bulk-email":{"post":{"tags":["Emails"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/email.html#send-bulk-emails","api_endpoint":"https://api.mailersend.com/v1/bulk-email"},"summary":"Send bulk emails","description":"Send bulk emails","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"text":{"type":"string","description":"Email text content"},"from":{"type":"object","description":"Sender email address and name","required":true,"properties":{}},"html":{"type":"string","description":"Email HTML content"},"personalization":{"type":"array","description":"Personalization data for each recipient","items":{"type":"string"}},"subject":{"type":"string","description":"Email subject","required":true},"tags":{"type":"array","description":"Array of tags (limit is max 5 tags)","items":{"type":"string"}},"template_id":{"type":"string","description":"Template ID to use"},"to":{"type":"array","description":"Array of recipient objects","required":true,"items":{"type":"string"}}}},"example":{"text":"","from":{"email":"","name":""},"html":"","personalization":[{"data":{},"email":""}],"subject":"","tags":[],"template_id":"","to":[{"email":"","name":""}]}}}}}},"/v1/domains":{"get":{"tags":["Domains"],"parameters":[{"name":"limit","in":"query","description":"Number of results per page","required":false,"schema":{"type":"number","example":""}},{"name":"page","in":"query","description":"Page number","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/domains.html#get-a-list-of-domains","api_endpoint":"https://api.mailersend.com/v1/domains"},"summary":"List domains","description":"Get a list of all domains","security":[{"bearerAuth":[]}]},"post":{"tags":["Domains"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/domains.html#create-a-domain","api_endpoint":"https://api.mailersend.com/v1/domains"},"summary":"Create a domain","description":"Create a new domain","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"name":{"type":"string","description":"Domain name","required":true}}},"example":{"name":""}}}}}},"/v1/domains/{domain_id}":{"get":{"tags":["Domains"],"parameters":[{"name":"domain_id","in":"path","description":"Domain ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/domains.html#get-a-single-domain","api_endpoint":"https://api.mailersend.com/v1/domains/{domain_id}"},"summary":"Get a domain","description":"Get a single domain","security":[{"bearerAuth":[]}]},"put":{"tags":["Domains"],"parameters":[{"name":"domain_id","in":"path","description":"Domain ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/domains.html#update-a-domain","api_endpoint":"https://api.mailersend.com/v1/domains/{domain_id}"},"summary":"Update a domain","description":"Update a domain","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"custom_tracking_subdomain":{"type":"string","description":"Custom tracking subdomain"},"name":{"type":"string","description":"Domain name"},"return_path_subdomain":{"type":"string","description":"Return path subdomain"}}},"example":{"custom_tracking_subdomain":"","name":"","return_path_subdomain":""}}}}},"delete":{"tags":["Domains"],"parameters":[{"name":"domain_id","in":"path","description":"Domain ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/domains.html#delete-a-domain","api_endpoint":"https://api.mailersend.com/v1/domains/{domain_id}"},"summary":"Delete a domain","description":"Delete a domain","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1/domains/{domain_id}/verify":{"get":{"tags":["Domains"],"parameters":[{"name":"domain_id","in":"path","description":"Domain ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/domains.html#verify-a-domain","api_endpoint":"https://api.mailersend.com/v1/domains/{domain_id}/verify"},"summary":"Verify a domain","description":"Verify a domain","security":[{"bearerAuth":[]}]}},"/v1/domains/{domain_id}/dns-records":{"get":{"tags":["Domains"],"parameters":[{"name":"domain_id","in":"path","description":"Domain ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/domains.html#get-dns-records","api_endpoint":"https://api.mailersend.com/v1/domains/{domain_id}/dns-records"},"summary":"Get DNS records","description":"Get DNS records for a domain","security":[{"bearerAuth":[]}]}},"/v1/templates":{"get":{"tags":["Templates"],"parameters":[{"name":"limit","in":"query","description":"Number of results per page","required":false,"schema":{"type":"number","example":""}},{"name":"page","in":"query","description":"Page number","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/templates.html#get-a-list-of-templates","api_endpoint":"https://api.mailersend.com/v1/templates"},"summary":"List templates","description":"Get a list of all templates","security":[{"bearerAuth":[]}]},"post":{"tags":["Templates"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/templates.html#create-a-template","api_endpoint":"https://api.mailersend.com/v1/templates"},"summary":"Create a template","description":"Create a new template","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"text":{"type":"string","description":"Text content of the template"},"html":{"type":"string","description":"HTML content of the template"},"name":{"type":"string","description":"Template name","required":true},"subject":{"type":"string","description":"Default subject for the template"}}},"example":{"text":"","html":"","name":"","subject":""}}}}}},"/v1/templates/{template_id}":{"get":{"tags":["Templates"],"parameters":[{"name":"template_id","in":"path","description":"Template ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/templates.html#get-a-single-template","api_endpoint":"https://api.mailersend.com/v1/templates/{template_id}"},"summary":"Get a template","description":"Get a single template","security":[{"bearerAuth":[]}]},"put":{"tags":["Templates"],"parameters":[{"name":"template_id","in":"path","description":"Template ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/templates.html#update-a-template","api_endpoint":"https://api.mailersend.com/v1/templates/{template_id}"},"summary":"Update a template","description":"Update a template","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"text":{"type":"string","description":"Text content of the template"},"html":{"type":"string","description":"HTML content of the template"},"name":{"type":"string","description":"Template name"},"subject":{"type":"string","description":"Default subject for the template"}}},"example":{"text":"","html":"","name":"","subject":""}}}}},"delete":{"tags":["Templates"],"parameters":[{"name":"template_id","in":"path","description":"Template ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/templates.html#delete-a-template","api_endpoint":"https://api.mailersend.com/v1/templates/{template_id}"},"summary":"Delete a template","description":"Delete a template","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1/webhooks":{"get":{"tags":["Webhooks"],"parameters":[{"name":"domain_id","in":"query","description":"Filter by domain ID","required":false,"schema":{"type":"string","example":""}},{"name":"limit","in":"query","description":"Number of results per page","required":false,"schema":{"type":"number","example":""}},{"name":"page","in":"query","description":"Page number","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/webhooks.html#get-a-list-of-webhooks","api_endpoint":"https://api.mailersend.com/v1/webhooks"},"summary":"List webhooks","description":"Get a list of all webhooks","security":[{"bearerAuth":[]}]},"post":{"tags":["Webhooks"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/webhooks.html#create-a-webhook","api_endpoint":"https://api.mailersend.com/v1/webhooks"},"summary":"Create a webhook","description":"Create a new webhook","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"domain_id":{"type":"string","description":"Domain ID"},"events":{"type":"array","description":"Array of event types to subscribe to","required":true,"items":{"type":"string"}},"name":{"type":"string","description":"Webhook name"},"url":{"type":"string","description":"Webhook URL","required":true}}},"example":{"domain_id":"","events":["activity.sent","activity.delivered","activity.soft_bounced","activity.hard_bounced","activity.opened","activity.clicked","activity.unsubscribed","activity.spam_complaint"],"name":"","url":""}}}}}},"/v1/webhooks/{webhook_id}":{"get":{"tags":["Webhooks"],"parameters":[{"name":"webhook_id","in":"path","description":"Webhook ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/webhooks.html#get-a-single-webhook","api_endpoint":"https://api.mailersend.com/v1/webhooks/{webhook_id}"},"summary":"Get a webhook","description":"Get a single webhook","security":[{"bearerAuth":[]}]},"put":{"tags":["Webhooks"],"parameters":[{"name":"webhook_id","in":"path","description":"Webhook ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/webhooks.html#update-a-webhook","api_endpoint":"https://api.mailersend.com/v1/webhooks/{webhook_id}"},"summary":"Update a webhook","description":"Update a webhook","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"events":{"type":"array","description":"Array of event types to subscribe to","items":{"type":"string"}},"name":{"type":"string","description":"Webhook name"},"url":{"type":"string","description":"Webhook URL"}}},"example":{"events":["activity.sent","activity.delivered","activity.soft_bounced","activity.hard_bounced","activity.opened","activity.clicked","activity.unsubscribed","activity.spam_complaint"],"name":"","url":""}}}}},"delete":{"tags":["Webhooks"],"parameters":[{"name":"webhook_id","in":"path","description":"Webhook ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/webhooks.html#delete-a-webhook","api_endpoint":"https://api.mailersend.com/v1/webhooks/{webhook_id}"},"summary":"Delete a webhook","description":"Delete a webhook","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1/activity":{"get":{"tags":["Activity"],"parameters":[{"name":"date_from","in":"query","description":"Unix timestamp - start date","required":false,"schema":{"type":"number","example":""}},{"name":"date_to","in":"query","description":"Unix timestamp - end date","required":false,"schema":{"type":"number","example":""}},{"name":"domain_id","in":"query","description":"Filter by domain ID","required":false,"schema":{"type":"string","example":""}},{"name":"event","in":"query","description":"Filter by event type","required":false,"schema":{"type":"string","example":""}},{"name":"limit","in":"query","description":"Number of results per page","required":false,"schema":{"type":"number","example":""}},{"name":"page","in":"query","description":"Page number","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/activity.html#get-a-list-of-events","api_endpoint":"https://api.mailersend.com/v1/activity"},"summary":"List activity events","description":"Get a list of activity events","security":[{"bearerAuth":[]}]}},"/v1/activity/{event_id}":{"get":{"tags":["Activity"],"parameters":[{"name":"event_id","in":"path","description":"Event ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/activity.html#get-a-single-event","api_endpoint":"https://api.mailersend.com/v1/activity/{event_id}"},"summary":"Get an activity event","description":"Get a single activity event","security":[{"bearerAuth":[]}]}},"/v1/suppressions/bounces":{"get":{"tags":["Suppressions"],"parameters":[{"name":"domain_id","in":"query","description":"Filter by domain ID","required":false,"schema":{"type":"string","example":""}},{"name":"limit","in":"query","description":"Number of results per page","required":false,"schema":{"type":"number","example":""}},{"name":"page","in":"query","description":"Page number","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/suppressions.html#get-a-list-of-bounces","api_endpoint":"https://api.mailersend.com/v1/suppressions/bounces"},"summary":"List bounces","description":"Get a list of bounces","security":[{"bearerAuth":[]}]},"post":{"tags":["Suppressions"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/suppressions.html#add-bounces","api_endpoint":"https://api.mailersend.com/v1/suppressions/bounces"},"summary":"Add bounces","description":"Add email addresses to bounces","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"domain_id":{"type":"string","description":"Domain ID"},"recipients":{"type":"array","description":"Array of email addresses to add to bounces","required":true,"items":{"type":"string"}}}},"example":{"domain_id":"","recipients":[]}}}}}},"/v1/suppressions/bounces/{suppression_id}":{"delete":{"tags":["Suppressions"],"parameters":[{"name":"suppression_id","in":"path","description":"Suppression ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/suppressions.html#delete-a-bounce","api_endpoint":"https://api.mailersend.com/v1/suppressions/bounces/{suppression_id}"},"summary":"Delete a bounce","description":"Delete a bounce","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1/suppressions/unsubscribes":{"get":{"tags":["Suppressions"],"parameters":[{"name":"domain_id","in":"query","description":"Filter by domain ID","required":false,"schema":{"type":"string","example":""}},{"name":"limit","in":"query","description":"Number of results per page","required":false,"schema":{"type":"number","example":""}},{"name":"page","in":"query","description":"Page number","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/suppressions.html#get-a-list-of-unsubscribes","api_endpoint":"https://api.mailersend.com/v1/suppressions/unsubscribes"},"summary":"List unsubscribes","description":"Get a list of unsubscribes","security":[{"bearerAuth":[]}]},"post":{"tags":["Suppressions"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/suppressions.html#add-unsubscribes","api_endpoint":"https://api.mailersend.com/v1/suppressions/unsubscribes"},"summary":"Add unsubscribes","description":"Add email addresses to unsubscribes","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"domain_id":{"type":"string","description":"Domain ID"},"recipients":{"type":"array","description":"Array of email addresses to add to unsubscribes","required":true,"items":{"type":"string"}}}},"example":{"domain_id":"","recipients":[]}}}}}},"/v1/suppressions/unsubscribes/{suppression_id}":{"delete":{"tags":["Suppressions"],"parameters":[{"name":"suppression_id","in":"path","description":"Suppression ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/suppressions.html#delete-an-unsubscribe","api_endpoint":"https://api.mailersend.com/v1/suppressions/unsubscribes/{suppression_id}"},"summary":"Delete an unsubscribe","description":"Delete an unsubscribe","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1/suppressions/spam":{"get":{"tags":["Suppressions"],"parameters":[{"name":"domain_id","in":"query","description":"Filter by domain ID","required":false,"schema":{"type":"string","example":""}},{"name":"limit","in":"query","description":"Number of results per page","required":false,"schema":{"type":"number","example":""}},{"name":"page","in":"query","description":"Page number","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/suppressions.html#get-a-list-of-spam-complaints","api_endpoint":"https://api.mailersend.com/v1/suppressions/spam"},"summary":"List spam complaints","description":"Get a list of spam complaints","security":[{"bearerAuth":[]}]},"post":{"tags":["Suppressions"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/suppressions.html#add-spam-complaints","api_endpoint":"https://api.mailersend.com/v1/suppressions/spam"},"summary":"Add spam complaints","description":"Add email addresses to spam complaints","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"domain_id":{"type":"string","description":"Domain ID"},"recipients":{"type":"array","description":"Array of email addresses to add to spam complaints","required":true,"items":{"type":"string"}}}},"example":{"domain_id":"","recipients":[]}}}}}},"/v1/suppressions/spam/{suppression_id}":{"delete":{"tags":["Suppressions"],"parameters":[{"name":"suppression_id","in":"path","description":"Suppression ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/suppressions.html#delete-a-spam-complaint","api_endpoint":"https://api.mailersend.com/v1/suppressions/spam/{suppression_id}"},"summary":"Delete a spam complaint","description":"Delete a spam complaint","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1/tokens":{"get":{"tags":["Tokens"],"parameters":[{"name":"limit","in":"query","description":"Number of results per page","required":false,"schema":{"type":"number","example":""}},{"name":"page","in":"query","description":"Page number","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/tokens.html#get-a-list-of-tokens","api_endpoint":"https://api.mailersend.com/v1/tokens"},"summary":"List tokens","description":"Get a list of all tokens","security":[{"bearerAuth":[]}]},"post":{"tags":["Tokens"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/tokens.html#create-a-token","api_endpoint":"https://api.mailersend.com/v1/tokens"},"summary":"Create a token","description":"Create a new token","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"name":{"type":"string","description":"Token name","required":true},"scopes":{"type":"array","description":"Array of scopes for the token","required":true,"items":{"type":"string"}}}},"example":{"name":"","scopes":["email_full","domains_read","domains_full","templates_read","templates_full","tokens_read","tokens_full","webhooks_read","webhooks_full","activity_read","activity_full","analytics_read","analytics_full"]}}}}}},"/v1/tokens/{token_id}":{"get":{"tags":["Tokens"],"parameters":[{"name":"token_id","in":"path","description":"Token ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/tokens.html#get-a-single-token","api_endpoint":"https://api.mailersend.com/v1/tokens/{token_id}"},"summary":"Get a token","description":"Get a single token","security":[{"bearerAuth":[]}]},"put":{"tags":["Tokens"],"parameters":[{"name":"token_id","in":"path","description":"Token ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/tokens.html#update-a-token","api_endpoint":"https://api.mailersend.com/v1/tokens/{token_id}"},"summary":"Update a token","description":"Update a token","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"name":{"type":"string","description":"Token name"},"status":{"type":"string","description":"Token status","enum":["active","paused"]}}},"example":{"name":"","status":""}}}}},"delete":{"tags":["Tokens"],"parameters":[{"name":"token_id","in":"path","description":"Token ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/tokens.html#delete-a-token","api_endpoint":"https://api.mailersend.com/v1/tokens/{token_id}"},"summary":"Delete a token","description":"Delete a token","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1/recipients":{"get":{"tags":["Recipients"],"parameters":[{"name":"limit","in":"query","description":"Number of results per page","required":false,"schema":{"type":"number","example":""}},{"name":"list_id","in":"query","description":"Filter by list ID","required":false,"schema":{"type":"string","example":""}},{"name":"page","in":"query","description":"Page number","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/recipients.html#get-a-list-of-recipients","api_endpoint":"https://api.mailersend.com/v1/recipients"},"summary":"List recipients","description":"Get a list of all recipients","security":[{"bearerAuth":[]}]},"post":{"tags":["Recipients"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/recipients.html#create-a-recipient","api_endpoint":"https://api.mailersend.com/v1/recipients"},"summary":"Create a recipient","description":"Create a new recipient","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"email":{"type":"string","description":"Recipient email address","required":true},"fields":{"type":"object","description":"Custom fields for the recipient","properties":{}}}},"example":{"email":"","fields":{}}}}}}},"/v1/recipients/{recipient_id}":{"get":{"tags":["Recipients"],"parameters":[{"name":"recipient_id","in":"path","description":"Recipient ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/recipients.html#get-a-single-recipient","api_endpoint":"https://api.mailersend.com/v1/recipients/{recipient_id}"},"summary":"Get a recipient","description":"Get a single recipient","security":[{"bearerAuth":[]}]},"put":{"tags":["Recipients"],"parameters":[{"name":"recipient_id","in":"path","description":"Recipient ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/recipients.html#update-a-recipient","api_endpoint":"https://api.mailersend.com/v1/recipients/{recipient_id}"},"summary":"Update a recipient","description":"Update a recipient","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"fields":{"type":"object","description":"Custom fields for the recipient","properties":{}}}},"example":{"fields":{}}}}}},"delete":{"tags":["Recipients"],"parameters":[{"name":"recipient_id","in":"path","description":"Recipient ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/recipients.html#delete-a-recipient","api_endpoint":"https://api.mailersend.com/v1/recipients/{recipient_id}"},"summary":"Delete a recipient","description":"Delete a recipient","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1/lists":{"get":{"tags":["Recipients"],"parameters":[{"name":"limit","in":"query","description":"Number of results per page","required":false,"schema":{"type":"number","example":""}},{"name":"page","in":"query","description":"Page number","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/lists.html#get-a-list-of-lists","api_endpoint":"https://api.mailersend.com/v1/lists"},"summary":"List recipient lists","description":"Get a list of all recipient lists","security":[{"bearerAuth":[]}]},"post":{"tags":["Recipients"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/lists.html#create-a-list","api_endpoint":"https://api.mailersend.com/v1/lists"},"summary":"Create a recipient list","description":"Create a new recipient list","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"name":{"type":"string","description":"List name","required":true}}},"example":{"name":""}}}}}},"/v1/lists/{list_id}":{"get":{"tags":["Recipients"],"parameters":[{"name":"list_id","in":"path","description":"List ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/lists.html#get-a-single-list","api_endpoint":"https://api.mailersend.com/v1/lists/{list_id}"},"summary":"Get a recipient list","description":"Get a single recipient list","security":[{"bearerAuth":[]}]},"put":{"tags":["Recipients"],"parameters":[{"name":"list_id","in":"path","description":"List ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/lists.html#update-a-list","api_endpoint":"https://api.mailersend.com/v1/lists/{list_id}"},"summary":"Update a recipient list","description":"Update a recipient list","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"name":{"type":"string","description":"List name"}}},"example":{"name":""}}}}},"delete":{"tags":["Recipients"],"parameters":[{"name":"list_id","in":"path","description":"List ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/lists.html#delete-a-list","api_endpoint":"https://api.mailersend.com/v1/lists/{list_id}"},"summary":"Delete a recipient list","description":"Delete a recipient list","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1/lists/{list_id}/recipients":{"post":{"tags":["Recipients"],"parameters":[{"name":"list_id","in":"path","description":"List ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/lists.html#add-recipients-to-a-list","api_endpoint":"https://api.mailersend.com/v1/lists/{list_id}/recipients"},"summary":"Add recipients to a list","description":"Add recipients to a list","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"recipient_ids":{"type":"array","description":"Array of recipient IDs to add to the list","required":true,"items":{"type":"string"}}}},"example":{"recipient_ids":[]}}}}}},"/v1/lists/{list_id}/recipients/{recipient_id}":{"delete":{"tags":["Recipients"],"parameters":[{"name":"list_id","in":"path","description":"List ID","required":true,"schema":{"type":"string","example":""}},{"name":"recipient_id","in":"path","description":"Recipient ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.mailersend.com/api/v1/lists.html#remove-a-recipient-from-a-list","api_endpoint":"https://api.mailersend.com/v1/lists/{list_id}/recipients/{recipient_id}"},"summary":"Remove a recipient from a list","description":"Remove a recipient from a list","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"security":[{"bearerAuth":[]}]}