--- title: "Creates one or more brand profiles for an account." method: POST path: "/v2.1/accounts/{accountId}/brands" tags: ["AccountBrands"] --- # Creates one or more brand profiles for an account. `POST /v2.1/accounts/{accountId}/brands` This method creates one or more brand profile files for an account. To specify logos for the brand, use the [AccountBrands: updateLogo](/docs/esign-rest-api/reference/accounts/accountbrands/updatelogo/) method after you create the brand. Either or both of the following settings must be enabled for the account to use this method: - `canSelfBrandSign` - `canSelfBrandSend` ### Related topics - [How to create a brand](/docs/esign-rest-api/how-to/create-brand/) ## Path parameters - `accountId` string, required ## Request body - Brand — Information about a brand that is associated with an account. A brand applies custom styles and text to an envelope. - `brandCompany` string — The name of the company associated with the brand. - `brandId` string — The ID used to identify a specific brand in API calls. - `brandLanguages` string[] — An array of two-letter codes for the languages that you want to use with the brand. The supported languages are: - Arabic (`ar`) - Armenian (`hy`) - Bahasa Indonesia (`id`) - Bahasa Malay (`ms`) - Bulgarian (`bg`) - Chinese Simplified (`zh_CN`) - Chinese Traditional (`zh_TW`) - Croatian (`hr`) - Czech (`cs`) - Danish (`da`) - Dutch (`nl`) - English UK (`en_GB`) - English US (`en`) - Estonian (`et`) - Farsi (`fa`) - Finnish (`fi`) - French (`fr`) - French Canada (`fr_CA`) - German (`de`) - Greek (`el`) - Hebrew (`he`) - Hindi (`hi`) - Hungarian (`hu`) - Italian (`it`) - Japanese (`ja`) - Korean (`ko`) - Latvian (`lv`) - Lithuanian (`lt`) - Norwegian (`no`) - Polish (`pl`) - Portuguese (`pt`) - Portuguese Brasil (`pt_BR`) - Romanian (`ro`) - Russian (`ru`) - Serbian (`sr`) - Slovak (`sk`) - Slovenian (`sl`) - Spanish (`es`) - Spanish Latin America (`es_MX`) - Swedish (`sv`) - Thai (`th`) - Turkish (`tr`) - Ukranian (`uk`) - Vietnamese (`vi`) - `brandName` string — The name of the brand. - `colors` NameValue[] — An array of name-value pairs specifying the colors that the brand uses for the following elements: - Button background - Button text - Header background - Header text - `errorDetails` ErrorDetails — This object describes errors that occur. It is only valid for responses and ignored in requests. - `errorCode` string — The code associated with the error condition. - `message` string — A brief message describing the error condition. - `name` string — The name of the item. - `originalValue` string — The initial value of the item. - `value` string — The current value of the item. - `defaultBrandLanguage` string — The two-letter code for the language that you want to use as the brand default. The supported languages are: - Arabic (`ar`) - Armenian (`hy`) - Bahasa Indonesia (`id`) - Bahasa Malay (`ms`) - Bulgarian (`bg`) - Chinese Simplified (`zh_CN`) - Chinese Traditional (`zh_TW`) - Croatian (`hr`) - Czech (`cs`) - Danish (`da`) - Dutch (`nl`) - English UK (`en_GB`) - English US (`en`) - Estonian (`et`) - Farsi (`fa`) - Finnish (`fi`) - French (`fr`) - French Canada (`fr_CA`) - German (`de`) - Greek (`el`) - Hebrew (`he`) - Hindi (`hi`) - Hungarian (`hu`) - Italian (`it`) - Japanese (`ja`) - Korean (`ko`) - Latvian (`lv`) - Lithuanian (`lt`) - Norwegian (`no`) - Polish (`pl`) - Portuguese (`pt`) - Portuguese Brasil (`pt_BR`) - Romanian (`ro`) - Russian (`ru`) - Serbian (`sr`) - Slovak (`sk`) - Slovenian (`sl`) - Spanish (`es`) - Spanish Latin America (`es_MX`) - Swedish (`sv`) - Thai (`th`) - Turkish (`tr`) - Ukranian (`uk`) - Vietnamese (`vi`) - `emailContent` BrandEmailContent[] — Deprecated. - `content` string — Deprecated. - `emailContentType` string — Deprecated. - `emailToLink` string — Deprecated. - `linkText` string — Deprecated. - `errorDetails` ErrorDetails — This object describes errors that occur. It is only valid for responses and ignored in requests. - `errorCode` string — The code associated with the error condition. - `message` string — A brief message describing the error condition. - `isOrganizationBrand` string - `isOverridingCompanyName` boolean — When **true,** the `brandCompany` property is overriding the name of the company in the account settings. - `isSendingDefault` boolean — When **true,** the sending brand is the default brand for sending new envelopes. - `isSigningDefault` boolean — When **true,** the siging brand is the default brand for the signing experience. - `landingPages` NameValue[] — An array of name/value pairs specifying the pages to which the user is redirected after the following events occur: - Signing Completed - Viewed Exit - Finish Later - Decline - Session Timeout - Authentication Failure If you do not specify landing pages, the Docusign default pages are used. - `errorDetails` ErrorDetails — This object describes errors that occur. It is only valid for responses and ignored in requests. - `errorCode` string — The code associated with the error condition. - `message` string — A brief message describing the error condition. - `name` string — The name of the item. - `originalValue` string — The initial value of the item. - `value` string — The current value of the item. - `links` BrandLink[] — An array of `brandLink` objects that contain information about the links that the brand uses. - `linkText` string — The text used for the link. - `linkType` string — The type of link. Valid values include: - `aboutDocusign` - `closeButton` - `showLink` string — When **true,** the link displays to the recipient. - `urlOrMailTo` string — The URL or mailto address of the link. - `logoIds` BrandLogoIds - `emailLogoId` string - `primaryLogoId` string - `secondaryLogoId` string - `logos` BrandLogos — The URIs for retrieving the logos that are associated with the brand. These are read-only properties that provide a URI to logos in use. To update a logo use [AccountBrands: updateLogo](/docs/esign-rest-api/reference/accounts/accountbrands/updatelogo/). - `email` string — The URI for the brand's secondary logo. This is a read-only property that provides a URI to the logo in use. To update a logo use [AccountBrands: updateLogo](/docs/esign-rest-api/reference/accounts/accountbrands/updatelogo/). - `primary` string — The URI for the brand's secondary logo. This is a read-only property that provides a URI to the logo in use. To update a logo use [AccountBrands: updateLogo](/docs/esign-rest-api/reference/accounts/accountbrands/updatelogo/). - `secondary` string — The URI for the brand's secondary logo. This is a read-only property that provides a URI to the logo in use. To update a logo use [AccountBrands: updateLogo](/docs/esign-rest-api/reference/accounts/accountbrands/updatelogo/). - `organizationBrandLogo` string - `resources` BrandResourceUrls — Brands use resource files to style the following experiences: - Email - Sending - Signing - Captive (embedded) signing You can modify these resource files to customize these experiences. - `email` string — The URI for the email resource file that the brand uses. - `sending` string — The URI for the sending resource file that the brand uses. - `signing` string — The URI for the signing resource file that the brand uses. - `signingCaptive` string — The URI for the captive (embedded) signing resource file that the brand uses. ## Response `201` Successful response. ## Other responses - `400` — Error encountered. --- [API](https://skmtc.net/docusign/apis/docusign-esignature-rest-api.md) · [All operations](https://skmtc.net/docusign/apis/docusign-esignature-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/docusign/docusign-esignature-rest-api/versions/77f1998c313d/schema)