sendsend.email
Sign inStart building

Update the brand kit

PUT/v1/brand

Changes only the fields you send. Use null to clear one.

Required scope: templates:manage

Request body

FieldType
logo_urloptionalany
logo_widthoptionalany
accentoptionalany
backgroundoptionalany
fontoptionalany
footer_textoptionalany

Unknown fields are rejected, so a typo never silently does nothing.

Example

curl -X PUT 'https://api.sendsend.email/v1/brand' \
  -H "Authorization: Bearer $SENDSEND_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "accent": "#ff5500",
  "logo_url": "https://acme.com/logo.png"
}'

Response 200

{
  "object": "brand_kit",
  "logo_url": "https://acme.com/logo.png",
  "logo_width": null,
  "accent": "#ff5500",
  "background": null,
  "font": null,
  "footer_text": null
}

Errors

StatusCodeWhen
400validation_errorThe request body or parameters are invalid. The message says which field.
401unauthorizedThe API key is missing, invalid or revoked.
403forbiddenThe key does not have the scope this endpoint needs.

Every error has the same shape. See Errors.