> For the complete documentation index, see [llms.txt](https://apidocs.zerionsoftware.com/doc/iformbuilder-v81/llms.txt)

# Update Page Email Alert Settings

> PUT /profiles/{profile_id}/pages/{page_id}/email_alerts/settings
> 
> Replaces the CC list, the BCC list or the subject element of the page's email alert. Only the fields in the body are written, and each one replaces its stored value as a whole. An empty list clears `cc` or `bcc`. `null` or an empty string clears `subject_element`.
> 
> Duplicate addresses are stored once. `subject_element` must name an element of the page with a data type of 1 (Text), 7 (Select), 8 (Pick List), 9 (Multi Select), 19 (Text Area) or 25 (Unique ID). It is stored as the element's own name, whatever the letter case sent.
> 
> ### Authorization
> 
> Same as `GET /profiles/{profile_id}/pages/{page_id}/email_alerts/settings`.



## Servers
- https://api.iformbuilder.com/exzact/api/v81/[servername]: https://api.iformbuilder.com/exzact/api/v81/[servername]


## Authentication methods
- Oauth2


## Parameters
### Headers

- **Authorization** (string)
  e.g. Bearer {access_token}


### Path parameters

- **profile_id** (string)
  id of the profile

- **page_id** (number)
  id of the page



### Body: application/json (object)

- **cc** (array[string])
  the full CC list

- **bcc** (array[string])
  the full BCC list

- **subject_element** (string | null)
  name of the element whose value is the subject



## Responses
### 200
OK - the settings were saved. The body is the updated settings, in the same shape as `GET`.

#### Body: application/json (object)
- **cc** (array[string])
  addresses copied on each alert

- **bcc** (array[string])
  addresses blind-copied on each alert

- **subject_element** (string | null)
  name of the element whose value is the subject; `null` when none is set


### 400
Bad Request - the body is not a JSON object, `cc` or `bcc` is not a list of valid email addresses or is longer than 1000 characters once joined with `, `, or `subject_element` does not name an element of the page that can be a subject. Nothing was written.

#### Body: application/json (object)
- **error_message** (string)
  human-readable reason for the failure


### 401
Unauthorized - missing or invalid bearer token.

### 403
Forbidden - the user cannot assign the page.

#### Body: application/json (object)
- **error_message** (string)
  human-readable reason for the failure


### 404
Not Found - `page_id` does not exist, is not a page of `profile_id`, or is a form shared from another profile.

#### Body: application/json (object)
- **error_message** (string)
  human-readable reason for the failure



[Powered by Bump.sh](https://bump.sh)
