# WEBHOOK Form submitted

Deprecated. Delivered when a customer submits a Sign Customiser form workflow. Read submissions from GET /api/v3/quotes with the quotes:read scope instead, and deduplicate on the quote id. This webhook still fires on every submission with an unchanged payload, and has no removal date.

- Source URL: https://www.signcustomiser.com/help/api/webhook-form-submitted/
- Markdown URL: https://www.signcustomiser.com/help/api/webhook-form-submitted.md
- Group: Webhook events
- Method: WEBHOOK
- Path: form:submitted

## Deprecated webhook topic

Deprecated on 24 August 2026. Delivery is unchanged: this topic still fires on every new submission with the same payload, and no removal date is scheduled. Its payload carries no stable resource id, so a consumer running it alongside the API cannot reliably match a delivery to a record. Read submissions from GET /api/v3/quotes with the quotes:read scope and deduplicate on the quote id.

[Read quotes over the API](https://www.signcustomiser.com/help/api/v3-get-list-quotes/).

## Body parameters

- form_submission (object, optional): No description provided.

## Request body example

```json
{
  "form_submission": {
    "submission_number": 1234,
    "type": "custom_form_submission",
    "form": {
      "form_id": 1,
      "customiser_id": 1,
      "label": "Custom Design Form",
      "description": "Lorem ipsum dolor",
      "email": "test@test.com",
      "subject": "My Custom Email Subject",
      "created_at": "2024-01-01T00:00:00.000000Z",
      "updated_at": "2024-01-01T00:00:00.000000Z"
    },
    "responses": [
      {
        "field_id": "abcd1234",
        "value": "test@test.com",
        "name": "Your Email",
        "input_type": "EMAIL"
      }
    ],
    "created_at": "2024-01-01T00:00:00.000000Z"
  }
}
```

## cURL example

```bash
curl https://your-app.example.com/sign-customiser/webhooks \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'x-webhook-timestamp: 1704067200' \
  --header 'x-webhook-signature: YOUR_GENERATED_SIGNATURE' \
  --data '{
  "form_submission": {
    "submission_number": 1234,
    "type": "custom_form_submission",
    "form": {
      "form_id": 1,
      "customiser_id": 1,
      "label": "Custom Design Form",
      "description": "Lorem ipsum dolor",
      "email": "test@test.com",
      "subject": "My Custom Email Subject",
      "created_at": "2024-01-01T00:00:00.000000Z",
      "updated_at": "2024-01-01T00:00:00.000000Z"
    },
    "responses": [
      {
        "field_id": "abcd1234",
        "value": "test@test.com",
        "name": "Your Email",
        "input_type": "EMAIL"
      }
    ],
    "created_at": "2024-01-01T00:00:00.000000Z"
  }
}'
```

## Response examples

### 200 Acknowledge delivery

```json
{
  "ok": true
}
```