> For the complete documentation index, see [llms.txt](https://mobile-calendar.gitbook.io/v1/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mobile-calendar.gitbook.io/v1/rest-api/smtp.md).

# Smtp

SMTP accounts available for sending e-mail messages.

## List SMTP accounts

> Returns SMTP accounts configured by the user that can be used for sending e-mails. Required scope: \`smtp.read\`.

```json
{"openapi":"3.0.0","info":{"title":"Public REST API v1 – mobile-calendar.com","version":"1.0.0"},"tags":[{"name":"smtp","description":"SMTP accounts available for sending e-mail messages."}],"servers":[{"url":"https://api.mobile-calendar.com/v1/public","description":"Production"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","description":"Pass the token in header: Authorization: Bearer <JWT>","bearerFormat":"JWT","scheme":"bearer"}},"schemas":{"SmtpAccountListResponse":{"required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/SmtpAccount"}},"meta":{"$ref":"#/components/schemas/MetaWithRuid"}},"type":"object"},"SmtpAccount":{"description":"SMTP account available for sending e-mails.","required":["smtpId","email","hostName","securityType","isVerified"],"properties":{"smtpId":{"type":"integer"},"email":{"type":"string","format":"email"},"hostName":{"type":"string"},"port":{"type":"integer","nullable":true},"securityType":{"type":"string","enum":["ssl","tls","none"]},"isVerified":{"description":"Only verified accounts can be used for sending.","type":"boolean"}},"type":"object"},"MetaWithRuid":{"description":"Metadata with request tracking.","required":["ruid"],"properties":{"ruid":{"description":"Request Unique ID","type":"string","format":"uuid"}},"type":"object"},"ApiProblem401":{"description":"Missing authentication or invalid credentials.","allOf":[{"$ref":"#/components/schemas/ApiProblemBase"},{"properties":{"type":{"description":"401 Unauthorized","type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"type":"object"}]},"ApiProblemBase":{"description":"RFC 7807 Problem Details (base schema).","required":["type","title","status","detail","instance"],"properties":{"type":{"description":"RFC 7807 base — DO NOT use directly in endpoints.\nIn endpoints reference ApiProblem400/401/403/409/422/429/500.","type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"type":"object"},"ApiProblem403":{"description":"Authenticated user but no access.","allOf":[{"$ref":"#/components/schemas/ApiProblemBase"},{"properties":{"type":{"description":"403 Forbidden","type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"type":"object"}]}}},"paths":{"/smtp-accounts":{"get":{"tags":["smtp"],"summary":"List SMTP accounts","description":"Returns SMTP accounts configured by the user that can be used for sending e-mails. Required scope: `smtp.read`.","operationId":"listSmtpAccounts","responses":{"200":{"description":"List of SMTP accounts","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SmtpAccountListResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiProblem401"}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiProblem403"}}}}}}}}}
```