{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Create a new brand button.<br><br>*Rate limits*:<br>Burst: `3/s`<br>Steady: `60/m`\n\n**Scopes:**\n`brands:write`\n\n[OpenAPI Spec](https://raw.githubusercontent.com/klaviyo/openapi/main/openapi/stable/apis/create_brand_button.json)","properties":{"query":{"type":"object","properties":{"fields[brand-button]":{"type":"array","items":{"type":"string","enum":["border","border.border_color","border.border_style","border.border_width","border.is_border_active","id","is_primary","name","preview_page_hex","spacing","spacing.padding_bottom","spacing.padding_left","spacing.padding_right","spacing.padding_top","style","style.background_color","style.border_radius","style.box_shadow","style.is_shadow_active","text","text.color","text.font_family","text.font_size","text.font_style","text.font_weight","text.letter_spacing","text.text_decoration"]},"description":"For more information please visit https://developers.klaviyo.com/en/v2026-10-15/reference/api-overview#sparse-fieldsets"}},"required":[],"additionalProperties":false},"headers":{"type":"object","properties":{"revision":{"type":"string","default":"2026-10-15","enum":["2026-10-15"],"description":"API endpoint revision (format: YYYY-MM-DD[.suffix])"}},"required":["revision"],"additionalProperties":false},"body":{"$ref":"#/definitions/BrandButtonCreateQuery"}},"required":["headers","body"],"additionalProperties":false,"definitions":{"BrandButtonCreateQuery":{"type":"object","properties":{"data":{"$ref":"#/definitions/BrandButtonCreateQueryResourceObject"}},"required":["data"]},"BrandButtonCreateQueryResourceObject":{"type":"object","properties":{"type":{"$ref":"#/definitions/BrandButtonEnum"},"attributes":{"type":"object","properties":{"style":{"$ref":"#/definitions/BrandLibraryButtonStyles"},"border":{"$ref":"#/definitions/BorderStyles"},"spacing":{"$ref":"#/definitions/SpacingStyles"},"text":{"$ref":"#/definitions/BrandLibraryTextStyles"},"name":{"description":"Human-readable name for this button.","type":["string","null"]},"is_primary":{"description":"Whether this button is the account's primary brand button. Setting to `true` demotes any existing primary.","type":["boolean","null"]},"preview_page_hex":{"description":"Optional hex color for the preview-page background.","type":["string","null"]}},"required":["style","border","spacing","text"]}},"required":["type","attributes"]},"BrandButtonEnum":{"type":"string","enum":["brand-button"]},"BrandLibraryButtonStyles":{"type":"object","properties":{"background_color":{"type":"string"},"border_radius":{"type":"integer"},"box_shadow":{"type":"string"},"is_shadow_active":{"type":"boolean","default":false}},"required":["background_color","border_radius","box_shadow"]},"BorderStyles":{"type":"object","properties":{"border_color":{"type":"string"},"border_style":{"description":"Border style.","type":"string","enum":["dashed","dotted","solid"]},"border_width":{"type":"integer"},"is_border_active":{"type":"boolean","default":false}},"required":["border_color","border_style","border_width"]},"SpacingStyles":{"type":"object","properties":{"padding_top":{"type":"integer"},"padding_right":{"type":"integer"},"padding_bottom":{"type":"integer"},"padding_left":{"type":"integer"}},"required":["padding_top","padding_right","padding_bottom","padding_left"]},"BrandLibraryTextStyles":{"type":"object","properties":{"color":{"type":"string"},"font_size":{"type":"integer"},"font_style":{"description":"Font style.","type":"string","enum":["italic","normal"]},"font_family":{"type":"string"},"font_weight":{"description":"Font weight.","type":"integer","enum":[100,200,300,400,500,600,700,800,900]},"letter_spacing":{"oneOf":[{"type":"string"},{"type":"integer"}]},"text_decoration":{"description":"Text decoration.","type":"string","enum":["","line-through","line-through underline","none","underline","underline line-through"]}},"required":["color","font_size","font_style","font_family","font_weight","letter_spacing","text_decoration"]}}},"name":"Create Brand Button","id":"klaviyo.create_brand_button","example":{"headers":{"revision":"2026-10-15"},"body":{"data":{"type":"brand-button","attributes":{"style":{"background_color":"example","border_radius":1,"box_shadow":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"},"border":{"border_color":"example","border_style":"dashed","border_width":1},"spacing":{"padding_top":1,"padding_right":1,"padding_bottom":1,"padding_left":1},"text":{"color":"example","font_size":1,"font_style":"italic","font_family":"example","font_weight":100,"letter_spacing":"example","text_decoration":""}}}}},"maxRequests":1,"summary":false}}