Accounts

Manage SMTP and Google sending identities. List and get responses never include passwords or OAuth tokens.

GET `/v1/accounts`

List accounts Returns all sending identities for the authenticated user, newest first. Passwords and OAuth tokens are never included.

Response fields

data (Account[]) — Public account fields only (no secrets).

Examples

200 — OK

{
  "data": [
    {
      "id": "uuid",
      "name": "Transactional",
      "provider_type": "smtp",
      "daily_mail_limit": 500
    }
  ]
}

cURL

curl -sS -X GET "https://api.mailofly.com/v1/accounts" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer mf_live_your_key_here"

POST `/v1/accounts`

Create account Create an SMTP or Google sending account. For SMTP, send smtp_host, smtp_port, smtp_username, smtp_password. For Google, send google_access_token and google_refresh_token (and usually google_email).

Request body — Body — SMTP

Omit smtp_password on PATCH to keep the current password.

{
  "name": "Transactional",
  "provider_type": "smtp",
  "daily_mail_limit": 500,
  "smtp_host": "smtp.example.com",
  "smtp_port": 587,
  "smtp_username": "user",
  "smtp_password": "secret"
}

Response fields

data (Account) — Created row.

Examples

201 — Created

{
  "data": { "id": "uuid", "name": "Transactional", "provider_type": "smtp" }
}

400 — Validation

{ "error": "…", "message": "…" }

cURL

curl -sS -X POST "https://api.mailofly.com/v1/accounts" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer mf_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"name":"Transactional","provider_type":"smtp","daily_mail_limit":500,"smtp_host":"smtp.example.com","smtp_port":587,"smtp_username":"user","smtp_password":"secret"}'

GET `/v1/accounts/{id}`

Get account Fetch one account by id. Returns 404 if the account does not exist or does not belong to you.

Response fields

data (Account) — Public fields only.

Examples

200 — OK

{ "data": { "id": "uuid", "name": "…" } }

404 — Not found

{ "error": "Not found" }

cURL

curl -sS -X GET "https://api.mailofly.com/v1/accounts/00000000-0000-0000-0000-000000000001" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer mf_live_your_key_here"

PATCH `/v1/accounts/{id}`

Update account Partial update. Omit smtp_password to keep the current stored password.

Request body — Body

{
  "name": "Renamed",
  "daily_mail_limit": 1000
}

Examples

200 — OK

{ "data": { … } }

404 — Not found

{ "error": "Not found" }

cURL

curl -sS -X PATCH "https://api.mailofly.com/v1/accounts/00000000-0000-0000-0000-000000000001" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer mf_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"name":"Renamed","daily_mail_limit":1000}'

DELETE `/v1/accounts/{id}`

Delete account Deletes the sending identity. Does not revoke Google tokens server-side beyond removing the row.

Examples

200 — OK

{ "ok": true }

404 — Not found

{ "error": "Not found" }

cURL

curl -sS -X DELETE "https://api.mailofly.com/v1/accounts/00000000-0000-0000-0000-000000000001" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer mf_live_your_key_here"

API Reference

Sending

Receiving

Campaigns

Templates

Contacts

Domains

Webhooks

Accounts

Accounts

GET `/v1/accounts`

Response fields

Examples

200 — OK

cURL

POST `/v1/accounts`

Request body — Body — SMTP

Response fields

Examples

201 — Created

400 — Validation

cURL

GET `/v1/accounts/{id}`

Response fields

Examples

200 — OK

404 — Not found

cURL

PATCH `/v1/accounts/{id}`

Request body — Body

Examples

200 — OK

404 — Not found

cURL

DELETE `/v1/accounts/{id}`

Examples

200 — OK

404 — Not found

cURL

​Accounts

​GET /v1/accounts

​Response fields

​Examples

​200 — OK

​cURL

​POST /v1/accounts

​Request body — Body — SMTP

​Response fields

​Examples

​201 — Created

​400 — Validation

​cURL

​GET /v1/accounts/{id}

​Response fields

​Examples

​200 — OK

​404 — Not found

​cURL

​PATCH /v1/accounts/{id}

​Request body — Body

​Examples

​200 — OK

​404 — Not found

​cURL

​DELETE /v1/accounts/{id}

​Examples

​200 — OK

​404 — Not found

​cURL

​Related

Accounts

GET `/v1/accounts`

Response fields

Examples

200 — OK

cURL

POST `/v1/accounts`

Request body — Body — SMTP

Response fields

Examples

201 — Created

400 — Validation

cURL

GET `/v1/accounts/{id}`

Response fields

Examples

200 — OK

404 — Not found

cURL

PATCH `/v1/accounts/{id}`

Request body — Body

Examples

200 — OK

404 — Not found

cURL

DELETE `/v1/accounts/{id}`

Examples

200 — OK

404 — Not found

cURL

Related