Sign Customiser

Customiser forms

Delete a form

Copy page

Removes the form and returns a deletion receipt: a snapshot of exactly what was removed, so the caller can verify and report the change. A form the customiser's settings still point at — its quote form or its AI designer fallback form — is refused with a 409 resource_in_use listing the referencing rows, and references are never silently cleared.

DELETE/api/v3/customisers/{customiser_id}/forms/{form_id}

Overview

Past submissions are historical records and are neither deleted nor counted as references. Requires customisers:write and an Idempotency-Key; retrying the same request and key replays the original receipt after the row is gone. The delete clears the customiser's cached storefront configuration and runs the advisory language sync, and never regenerates Shopify products, product images, or the product cache.

Authorisation

Bearer token required. Include it in theAuthorization header.

Required scope: customisers:write

Path parameters

customiser_idstringpathrequired

The customiser id.

Example: 1

form_idstringpathrequired

The form id.

Example: 7

Delete a form
curl https://web.signcustomiser.com/api/v3/customisers/1/forms/7 \
  --request DELETE \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'
Response
{
  "data": {
    "object": "form_deletion_receipt",
    "id": 7,
    "customiser_id": 42,
    "deleted": true,
    "resource": {
      "object": "form",
      "id": 7,
      "customiser_id": 42,
      "name": "Request a quote",
      "description": null,
      "form_type": "quote",
      "button_label": null,
      "subject": null,
      "recipient_emails": [],
      "save_customer_details": false,
      "post_submission_action": "default",
      "redirect_url": null,
      "emails_enabled": true,
      "suppressed_emails": [],
      "fields": [],
      "sort_order": 1,
      "created_at": "2026-08-14T00:00:00Z",
      "updated_at": "2026-08-14T00:00:00Z"
    }
  },
  "links": {
    "self": "https://web.signcustomiser.com/api/v3/customisers/42/forms/7",
    "documentation": "https://www.signcustomiser.com/help/api/"
  },
  "meta": {
    "api_version": "v3",
    "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
  }
}