---
title: "Create email brand resource"
method: PUT
path: "/v2/brands/{brand_id}/resources/email"
---

# Create email brand resource

`PUT /v2/brands/{brand_id}/resources/email`

## Request

- Base URL: `https://api.signnow.com`
- URL: `https://api.signnow.com/v2/brands/{brand_id}/resources/email`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/signnow/apis/signnow-api/docs/v2/brands/:brand_id/resources/email/put.ts> (a function with typed inputs; its response is checked against the schema)

> [!WARNING]
> This endpoint is deprecated.

This endpoint allows users to create and update an email brand resource.

## Request body

- object
  - `from` string: Sender's email address.
  - `logo` object: Logo object that contains attributes for logo positioning on the email page.
    - `position` string: Logo position on the email page. Possible values: `left`, `middle`, `right`.
  - `buttons` object: Button object that contains button attributes.
    - `color` string: Button main color in hex color code.
    - `background` string: Button background in hex color code.
  - `subject` string: Email subject.
  - `body_header` string: Email header text. Up to 300 symbols.
  - `body_message` string: Body text. Up to 300 hundred symbols.
  - `sender_email` string: Valid email address for `Contact Sender` button.
  - `footer_message` string: Footer text. Up to 300 symbols.
  - `signnow_references` boolean: Whether or not to show links to signNow mobile apps. Possible values: true, false.

## Response `201`

Created

## Other responses

- `400`: * Request without token/with invalid external bearer token/ with external app basic token * Request for `brand_id` where brand resource `email` already exists * Request without body * Request with `position` parameter values are invalid * Request with `position` parameter values are not string * Request with `color` parameter value which is not string * Request with `color` parameter value that doesn’t match the pattern (/^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$/) * Request with `background` parameter value which is not string * Request with `background` parameter value that doesn’t match the pattern (/^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$/) * Request with `subject-text` parameter value which is not string * Request with `subject-text` parameter value which are more than 300 characters * Request with `from-email` parameter value which is not string * Request with `from-email` parameter values which is not a valid email * Request with `header-text` parameter value which is not a string * Request with `header-text` parameter value which is more than 300 characters * Request with `payload-text` parameter value which is not string * Request with `payload-text` parameter value which is more than 300 characters * Request with `signature` parameter value which is not string * Request with `signature` parameter value which is more than 300 characters * Request with `show-mobile-devices` parameter value which is not a boolean * Request with `contact-sender` parameter value which is not string * Request with `contact-sender` parameter value which is not a valid email
- `403`: *Request with a valid bearer token from another user logged in * Request with bearer token from user, authorised with external token from app they don’t own
- `404`: * Request with `brand_id` that doesn't exist or is deleted * Request with `brand_id` which is null or invalid (not 40 characters)

---

[API](https://skmtc.dev/signnow/apis/signnow-api.md) - [All operations](https://skmtc.dev/signnow/apis/signnow-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signnow/apis/signnow-api/revisions/1c9c30a6142b?raw)