Runs examples for real against your account. Test keys only; kept in this tab, never stored on our side. Get a key
ZapSMTP / Docs / Domains

Update brand settings

PUT/v1/domains/{id}/brand

Set the default sender name and upload/remove the BIMI logo and certificate.

Requires a full-access live key; test keys get 403 test_key_restricted.

Hosted files are served publicly at /bimi/<domain>/logo.svg and /bimi/<domain>/cert.pem (outside /v1) for verified domains only.

Path parameters

idstringrequired
Domain id

Body parameters

from_namestring
Display name used when an email's from has only an address. "" clears it. Limits: max 70 characters, no < > " or line breaks → 422 invalid_parameter
logo_svgstring
SVG source; normalized to SVG Tiny PS (fixes reported in logo_fixed, warnings in logo_warnings). Limits: max 32 KB and valid SVG → otherwise 422 invalid_logo
cert_pemstring
VMC/CMC PEM chain (certificate, intermediate, root). Limits: 422 invalid_certificate
remove_logoboolean
Default False.
remove_certboolean
Default False.

Errors

restricted_api_keyHTTP 403
test_key_restrictedHTTP 403
test-mode keys can send test email and read, not change the account: use a live key
not_foundHTTP 404
domain not found
invalid_certificateHTTP 422
invalid_logoHTTP 422
invalid_parameterHTTP 422
PUT/v1/domains/{id}/brand
curl -X PUT 'https://zapsmtp.xyz/v1/domains/019a1e9b-41c2-7a0e-b5d1-3f6c2e8a9d47/brand' \
  -H "Authorization: Bearer $ZAP_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "from_name": "Acme"
}'
Set ZAP_API_KEY in your environment.

Response 200.