> For the complete documentation index, see [llms.txt](https://developers.incidents.cloud.solarwinds.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.incidents.cloud.solarwinds.com/python-sdk/docs/models/v3webformscreateorupdatewebformrequest.md).

# V3WebformsCreateOrUpdateWebformRequest

Public API request for creating a webform

## Fields

| Field                | Type                                                                                                                                                                                    | Required             | Description                                       |
| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | ------------------------------------------------- |
| `owner_id`           | *str*                                                                                                                                                                                   | :heavy\_check\_mark: | Unique identifier of the owner (string or UUID)   |
| `name`               | *str*                                                                                                                                                                                   | :heavy\_check\_mark: | Name of the webform                               |
| `is_cname`           | *bool*                                                                                                                                                                                  | :heavy\_check\_mark: | Indicates if a custom domain (CNAME) is used      |
| `host_name`          | *Optional\[str]*                                                                                                                                                                        | :heavy\_minus\_sign: | Custom hostname if CNAME is enabled               |
| `tags`               | [Optional\[models.V3WebformsCreateOrUpdateWebformRequestTags\]](https://developers.incidents.cloud.solarwinds.com/python-sdk/docs/models/v3webformscreateorupdatewebformrequesttags.md) | :heavy\_minus\_sign: | Key-value tags for the webform                    |
| `is_captcha_enabled` | *bool*                                                                                                                                                                                  | :heavy\_check\_mark: | Whether CAPTCHA is enabled on the form            |
| `captcha_secret`     | [models.V3WebformsRecaptchaSecrets](https://developers.incidents.cloud.solarwinds.com/python-sdk/docs/models/v3webformsrecaptchasecrets.md)                                             | :heavy\_check\_mark: | CAPTCHA credentials to be validated               |
| `form_owner_type`    | *str*                                                                                                                                                                                   | :heavy\_check\_mark: | Entity type that owns the form (e.g., team, user) |
| `form_owner_id`      | *str*                                                                                                                                                                                   | :heavy\_check\_mark: | Identifier for the owner entity                   |
| `services`           | List\[[models.V3WebformsWFService](https://developers.incidents.cloud.solarwinds.com/python-sdk/docs/models/v3webformswfservice.md)]                                                    | :heavy\_check\_mark: | List of services tied to this webform             |
| `input_field`        | List\[[models.V3WebformsWFInputField](https://developers.incidents.cloud.solarwinds.com/python-sdk/docs/models/v3webformswfinputfield.md)]                                              | :heavy\_minus\_sign: | Input fields to be rendered on the form           |
| `header`             | *str*                                                                                                                                                                                   | :heavy\_check\_mark: | Header text shown on the form                     |
| `title`              | *str*                                                                                                                                                                                   | :heavy\_check\_mark: | Title of the webform                              |
| `logo_url`           | *Optional\[str]*                                                                                                                                                                        | :heavy\_minus\_sign: | URL to the organization's logo                    |
| `footer_text`        | *str*                                                                                                                                                                                   | :heavy\_check\_mark: | Text displayed in the footer                      |
| `footer_link`        | *str*                                                                                                                                                                                   | :heavy\_check\_mark: | Hyperlink in the footer (mailto or https)         |
| `email_on`           | List\[*str*]                                                                                                                                                                            | :heavy\_minus\_sign: | Emails to notify on submission                    |
| `description`        | *Optional\[str]*                                                                                                                                                                        | :heavy\_minus\_sign: | Optional description for the webform              |
