PUT/v1/senders/:id

Update sender

Updates a sender's name, from-email, or SMTP/IMAP credentials without deleting it. Any changed SMTP or IMAP fields are live-verified (and re-encrypted) before saving — same as connect, so this can never save unverified credentials. SMTP-only, same as connect.

Stablescope: write API KeyLearn about API scopes →

Request

AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json

Parameters

FieldTypeRequiredDescription
idstringRequiredSender ID.
fromName, fromEmail, smtpHost, smtpPort, smtpUser, smtpPassword, imapHost, imapPort, imapUser, imapPasswordOptionalAny subset — only sent fields are changed.
curl -X PUT "https://api.stynar.com/v1/senders/sender_abc123" \
  -H "Authorization: Bearer esk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"fromName":"Alex Kim"}'

Response

200 OK
200 response
{
  "senderId": "sender_abc123",
  "fromName": "Alex Kim"
}

Response fields

Errors

StatusCodeMeaning
404 Not FoundNOT_FOUNDSender doesn't exist or isn't yours.
401 UnauthorizedUNAUTHORIZEDMissing, malformed, unknown, revoked, or expired key.
403 ForbiddenAPI_ACCESS_DISABLEDYour account doesn't currently have API access.
403 ForbiddenINSUFFICIENT_SCOPEThe key doesn't have the scope this endpoint requires.
404 Not FoundNOT_FOUNDUnknown route, or a resource that doesn't exist / isn't yours.
409 ConflictCONFLICTThe action can't be applied to the resource's current state.
429 Too Many RequestsRATE_LIMIT_EXCEEDEDPer-minute or per-second limit hit.
429 Too Many RequestsQUOTA_EXCEEDEDMonthly quota exhausted.
500 Internal Server ErrorINTERNAL_ERRORSomething broke on Stynar's end.
Full error reference →