---
title: "Update company"
method: PATCH
path: "/companies/{companyId}"
tags: ["Companies"]
---

# Update company

`PATCH /companies/{companyId}`

Updates product info, brand context, the default email theme, reply-tracking settings, and account-wide From/Reply-To defaults. New profiles are created as needed; From addresses require a verified sending domain. Requires the company_profile:manage scope; the sending-identity and reply-tracking fields additionally require companies:manage.

## Path parameters

- `companyId` string, required

## Request body

- object
  - `name` string
  - `description` string, nullable
  - `logoUrl` string, nullable
  - `founderName` string, nullable
  - `primaryColor` string — 6-digit hex color, for example
  - `brandColors` object, nullable
  - `valueProps` object[], nullable
  - `testimonials` object[], nullable
  - `toneVoice` string, nullable
  - `companyContext` string, nullable
  - `emailLengthPreference` 'concise' | 'balanced' | 'detailed' — How long AI-written email copy should be. New workspaces default to `concise`.
  - `socialLinks` object, nullable
  - `privacyPolicyUrl` string, nullable
  - `termsUrl` string, nullable
  - `address` string, nullable
  - `language` string
  - `pricing` object, nullable
  - `fontFamily` string, nullable
  - `emailTheme` object, nullable — Default email theme. Partial update - omitted fields keep their current value (or the preset default) and numeric values are clamped to supported ranges. Pass null to reset to the platform default theme.
    - `presetId` 'default' | 'soft' | 'editorial' | 'bold'
    - `colors` object — 6-digit hex values.
      - `primary` string
      - `background` string
      - `surface` string
      - `text` string
      - `mutedText` string
      - `heading` string
      - `border` string
      - `link` string
    - `typography` object — Numeric type settings.
      - `baseFontSize` number
      - `leadFontSize` number
      - `baseLineHeight` number
      - `heading1Size` number
      - `heading2Size` number
      - `heading3Size` number
      - `buttonFontSize` number
    - `layout` object — Numeric layout settings.
      - `contentWidth` number
      - `containerPaddingX` number
      - `containerPaddingY` number
      - `blockSpacing` number
      - `baseRadius` number
      - `sectionPadding` number
      - `buttonPaddingX` number
      - `buttonPaddingY` number
      - `borderedBlockPadding` number
  - `emailDirection` 'ltr' | 'rtl'
  - `senderProfileId` string — Existing sender profile to make the account-wide default, and the profile fromName renames. List IDs with GET /v1/sender-profiles. Mutually exclusive with fromEmail.
  - `fromEmail` string, email — Account-wide default From address. The domain must be configured and verified.
  - `fromName` string — Display name of the default From profile. Sent on its own it renames the current default profile; with senderProfileId it renames that profile; with fromEmail it names the profile for that address. If the address already carries several display names, the request is rejected - pass senderProfileId to say which one to rename.
  - `replyProfileId` string — Existing reply profile to make the account-wide default, and the profile replyToName renames. Mutually exclusive with replyTo.
  - `replyTo` string, email — Account-wide default Reply-To address. A reply profile is created when needed.
  - `replyToName` string — Display name of the default Reply-To profile. Sent on its own it renames the current default profile; with replyProfileId it renames that profile; with replyTo it names the profile for that address.
  - `replyTrackingEnabled` boolean — Enable or disable inbound reply capture.
  - `replyTrackingDomainMode` 'sequenzy' | 'custom' — Use Sequenzy's managed inbound domain or a configured custom domain.
  - `forwardReplies` boolean — Enable or disable forwarding captured replies to the configured mailbox.

## Response `200`

Company updated

- object
  - `success` boolean
  - `company` Company
    - `id` string
    - `name` string
    - `description` string, nullable
    - `status` string
    - `websiteUrl` string, nullable
    - `logoUrl` string, nullable
    - `founderName` string, nullable
    - `primaryColor` string, nullable
    - `brandColors` object, nullable
    - `valueProps` object[], nullable
    - `testimonials` object[], nullable
    - `toneVoice` string, nullable
    - `companyContext` string, nullable
    - `emailLengthPreference` 'concise' | 'balanced' | 'detailed' — How long AI-written email copy should be. New workspaces default to `concise`.
    - `socialLinks` object, nullable
    - `privacyPolicyUrl` string, nullable
    - `termsUrl` string, nullable
    - `address` string, nullable
    - `createdAt` string, date-time
    - `url` string, uri — Dashboard edit URL for this campaign.
    - `previewUrl` string, uri — Dashboard review/preview URL for this campaign.
    - `language` string
    - `pricing` object, nullable
    - `fontFamily` string, nullable
    - `emailTheme` object, nullable
    - `emailDirection` string
    - `emailLocalizationConfig` object
    - `defaultSenderProfileId` string, nullable
    - `defaultFromName` string, nullable
    - `defaultFromEmail` string, email, nullable
    - `defaultReplyProfileId` string, nullable
    - `defaultReplyToName` string, nullable
    - `defaultReplyToEmail` string, email, nullable
    - `replyTrackingEnabled` boolean — Whether inbound reply capture is enabled for this company.
    - `replyTrackingDomainMode` 'sequenzy' | 'custom' — Whether reply capture uses Sequenzy's managed inbound domain or a configured custom domain.
    - `forwardReplies` boolean — Whether captured replies are forwarded to the configured mailbox.
    - `replyRetentionDays` integer — Current reply retention period in days.

## Other responses

- `400` — Invalid update
- `401` — Unauthorized
- `403` — Sending-identity fields were sent without the companies:manage scope
- `404` — Company not found

---

[API](https://skmtc.net/sequenzy/apis/sequenzy-api.md) · [All operations](https://skmtc.net/sequenzy/apis/sequenzy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sequenzy/sequenzy-api/versions/af1cf9620482/schema)