---
title: "Create a Webform"
method: POST
path: "/1/newsletters/{domain}/webforms"
tags: ["Webforms"]
---

# Create a Webform

`POST /1/newsletters/{domain}/webforms`

Create a new Webform.

## Path parameters

- `domain` integer, required

## Request body

- object
  - `button` string
  - `confirmation_url` string
  - `design` string
  - `email_from_addr` string
  - `email_from_name` string
  - `email_title` string
  - `fields` object[]
    - `deleted` boolean
    - `error` string
    - `id` integer — Unique identifier of the resource `{name}`
    - `required` boolean
    - `selected` boolean
  - `groups` integer[]
  - `msg_ok` string
  - `msg_ok_redir` boolean
  - `name` string — Name of the resource `{name}`
  - `notify` boolean
  - `notify_address` string
  - `notify_lang` string
  - `placeholder` boolean
  - `rgpd` boolean
  - `rgpd_msg` string
  - `subtitle` string
  - `title` string
  - `validation_url` string

## Response `201`

Created

- object
  - `result` 'success' | 'error' | 'asynchronous', required — Result of the HTTP request
  - `data` 78d6c681Webform
    - `id` integer, required — Unique identifier of the resource `Webform`
    - `name` string, required — Name of the resource `Webform`
    - `title` string, required
    - `subtitle` string, required
    - `button` string, required
    - `msg_ok` string, required
    - `msg_ok_redir` string, required
    - `placeholder` string, required
    - `design` string, required
    - `rgpd` string, required
    - `rgpd_msg` string, required
    - `notify` string, required
    - `notify_address` string, required
    - `notify_lang` string, required
    - `confirmation_url` string, nullable, required
    - `validation_url` string, nullable, required
    - `template_email_id` integer, required
    - `template_confirmation_id` integer, required
    - `template_validation_id` integer, required
    - `email_title` string, required
    - `email_from_addr` string, required
    - `email_from_name` string, required
    - `codes` unknown[]
      - unknown
    - `fields` unknown[]
      - unknown
    - `groups` unknown[]
      - unknown
    - `statistics` object
    - `created_at` integer, required — Timestamp `Webform` has been created
    - `updated_at` integer, required — Timestamp `Webform` has been updated

## Other responses

- `401` — Unauthorized
- `404` — Not Found

---

[API](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools.md) · [All operations](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/infomaniak/api-reference-developer-tools/revisions/667aae28fec6/schema)