Create Auto Reply
Request, response and authentication details for your Mailat instance.
/api/v1/auto-repliesCreateAutoReply creates a new auto-reply POST /api/v1/auto-replies
Authentication & compatibility
This operation requires an active human session. API keys cannot call it. Additional role or MFA checks may apply.
Legacy stored configuration; not wired to SES ingestion. Storing a Sieve script, shared mailbox, auto-reply or forward does not enable its execution. Use /inbox/filters and external webhook workflows for supported SES organization/reply/forward automation.
Contract 2026-10-04. Your running instance's /api/v1/openapi.json is authoritative for its deployed release.
Request
Set MAILAT_BASE_URL to your instance origin (without /api/v1) and MAILAT_TOKEN to an appropriate credential. Replace path placeholders and example data before running. These examples do not execute in this page.
curl --request POST "$MAILAT_BASE_URL/api/v1/auto-replies" \
--header "Authorization: Bearer $MAILAT_TOKEN" \
--header 'Content-Type: application/json' \
--data @request.jsonBuild the request from the schema below; request.json and upload paths are local placeholders.
Request body (required)
application/json
bodyobjectrequiredFields · service.CreateAutoReplyInput
activebooleanendDateall of · nullableVariant 1string (date-time)excludePatternsarrayEach itemstringhtmlContentstringidentityIdsarrayEach iteminteger (int64)namestringreplyOncebooleanreplyToAllbooleanstartDatestring (date-time)subjectstringtextContentstringResponses
HTTP statuses and body shapes below come from the pinned contract. Not every shared error applies to every request. Retain the original idempotency key when retrying a send.
200 · Success
application/json
responseobjectFields
codeintegerrequireddataall of · nullableVariant 1objectFields · service.AutoReply
activebooleancreatedAtstring (date-time)endDateall of · nullableVariant 1string (date-time)excludePatternsarrayEach itemstringhtmlContentstringidinteger (int64)identityIdsarrayEach iteminteger (int64)lastRepliedAtall of · nullableVariant 1string (date-time)namestringorgIdinteger (int64)replyCountinteger (int64)replyOncebooleanreplyToAllbooleanstartDatestring (date-time)subjectstringtextContentstringupdatedAtstring (date-time)userIdinteger (int64)uuidstringmessagestringrequired400 · Invalid input
application/json
responseobjectFields
codeintegerrequiredmessagestringrequired401 · Missing, expired or revoked authentication
application/json
responseobjectFields
codeintegerrequiredmessagestringrequired403 · Insufficient permission
application/json
responseobjectFields
codeintegerrequiredmessagestringrequired404 · Resource not found
application/json
responseobjectFields
codeintegerrequiredmessagestringrequired409 · Conflict or changed idempotency payload
application/json
responseobjectFields
codeintegerrequiredmessagestringrequired410 · Recovery cursor expired; resynchronize
application/json
responseobjectFields
codeintegerrequiredmessagestringrequired429 · Rate limit exceeded; respect Retry-After
Header: Retry-AfterintegerSeconds until the next fixed-minute request window.
minimum: 1
application/json
responseobjectFields
codeintegerrequiredmessagestringrequired500 · Internal failure; retain the idempotency key
application/json
responseobjectFields
codeintegerrequiredmessagestringrequired