MisarMisar Docs
MisarMailMisarBlogMisarReachMisarPostMisarDevMisarCoderMisarSEOMisar PlatformMisar SSO
API Reference

Settings API

Read and set the outreach sender address for your MisarReach account — api.misar.io/reach/api/settings.

Account-level settings for outreach. Today this family manages the sender address used on outbound email.

Base URL: https://api.misar.io/reach/api · Auth: Authorization: Bearer mrk_…

Response bodies on the developer contract are open-form — the examples below show representative fields.

Get sender address

GET/api/settings/sender-address

Returns the currently configured sender address (and verification state). Required scope: settings:read.

Request
curl https://api.misar.io/reach/api/settings/sender-address \
  -H "Authorization: Bearer mrk_your_key_here"
200 — OK
{ "senderAddress": "sales@acme.com", "verified": true }

Set sender address

PUT/api/settings/sender-address

Sets the outreach sender address. Required scope: settings:write.

Request body

senderAddressstringbodyrequired

The from-address for outbound outreach. Must be a verifiable address on a domain you control.

Request
curl -X PUT https://api.misar.io/reach/api/settings/sender-address \
  -H "Authorization: Bearer mrk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "senderAddress": "sales@acme.com" }'
200 — OK
{ "ok": true, "senderAddress": "sales@acme.com", "verified": false }

Email delivery itself is handled by MisarMail — MisarReach never sends SMTP directly. See Cross-product contracts for how sends are gated by your MisarMail plan.

Status codes

CodeMeaning
200Sender address returned or updated
403Missing settings:read / settings:write scope
422Invalid sender address

See Errors.