Customisers
Duplicate a customiser
Copies one of the store's customisers into the same store: every option,
size, font, price list, form, label, colour scheme and language, as the
merchant admin Duplicate does. The copy is named name, or "Copy of"
and the source name when name is omitted or null.
Overview
It is live only when
the source is live and the store's plan has room for one more live
customiser; otherwise it is created inactive. The source is not changed.
Requires customisers:write and an Idempotency-Key. A source on
another store or a deleted one answers 404. A source priced by the
withdrawn fixed-height model is refused with 422
pricing_model_deprecated. The copy's storefront cache is cleared and
its languages are synchronised; no Shopify product is created.
Authorisation
Bearer token required. Include it in the Authorization header.
Required scope: customisers:write
Path parameters
The customiser to copy.
Example: 1
Request body
Request body example
{
"name": "Neon sign builder (wholesale)"
}curl https://web.signcustomiser.com/api/v3/customisers/1/duplicate \
--request POST \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_API_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
"name": "Neon sign builder (wholesale)"
}'{
"data": {
"object": "customiser",
"id": 43,
"name": "Neon sign builder (wholesale)",
"active": false,
"pricing_model": "frame_fit",
"pricing_model_display_name": "Frame Fit",
"sign_category": "neon",
"product_family": "neon",
"selection_mode": "per_word",
"created_at": "2026-11-16T00:00:00Z",
"updated_at": "2026-11-16T00:00:00Z"
},
"links": {
"self": "https://web.signcustomiser.com/api/v3/customisers/43",
"documentation": "https://www.signcustomiser.com/help/api/"
},
"meta": {
"api_version": "v3",
"request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}
}{
"type": "https://www.signcustomiser.com/help/api/problems/missing_idempotency_key",
"title": "Missing idempotency key",
"status": 400,
"code": "missing_idempotency_key",
"detail": "Provide an Idempotency-Key header for this write.",
"request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}{
"type": "https://www.signcustomiser.com/help/api/problems/insufficient_scope",
"title": "Insufficient scope",
"status": 403,
"code": "insufficient_scope",
"detail": "This operation requires the customisers:write scope.",
"required_scopes": [
"customisers:write"
],
"granted_scopes": [
"customisers:read"
],
"request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}{
"type": "https://www.signcustomiser.com/help/api/problems/resource_not_found",
"title": "Resource not found",
"status": 404,
"code": "resource_not_found",
"detail": "The requested resource does not exist or does not belong to the authenticated store.",
"request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}{
"type": "https://www.signcustomiser.com/help/api/problems/validation_failed",
"title": "Validation failed",
"status": 422,
"code": "validation_failed",
"detail": "The request body failed validation.",
"errors": [
{
"pointer": "/name",
"code": "max",
"detail": "The name field must not be greater than 255 characters."
}
],
"request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}