Stores
Attach the Store logo
Takes the raster image of a staged upload and makes it the Store logo,
returning the Store with logo_url pointing at the new file. Requires
store:write and an Idempotency-Key.
Overview
Create the upload first with POST/api/v3/uploads using purpose
store_logo, which also needs store:write. Send the bytes to the
presigned target it returns, then send that upload's id here. An upload
whose purpose is not store_logo answers 422 upload_purpose_mismatch.
The upload is single use: attaching it a second time answers 409.
Only PNG, JPEG and WebP are accepted, at most 2 MiB. The bytes are
verified here: the object must exist, be within the cap, start with the
magic bytes of its declared type and carry a readable image header. A
file that fails leaves the upload rejected with the failure's code.
Attaching over a logo that is already there replaces it. The previous
file is deleted once the new one is committed, unless something else
still uses it, so a URL published for it can stop resolving.
Branded emails show the new logo when use_branding_for_emails is true.
Authorisation
Bearer token required. Include it in the Authorization header.
Required scope: store:write
Request body
Request body example
{
"upload_id": "upl_9f2c4b7ad13e6058ba41cd4201"
}curl https://web.signcustomiser.com/api/v3/stores/me/logo \
--request PUT \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_API_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
"upload_id": "upl_9f2c4b7ad13e6058ba41cd4201"
}'{
"data": {
"object": "store",
"id": 1,
"name": "Demo Signs",
"platform": "universal",
"plan": "starter",
"currency": "GBP",
"integrations": [
{
"object": "integration",
"id": 17,
"type": "custom",
"name": "Warehouse bridge",
"enabled": true,
"accepts_writes": true
},
{
"object": "integration",
"id": 9,
"type": "woocommerce",
"name": "Old WooCommerce shop",
"enabled": false,
"accepts_writes": false
}
],
"scopes": [
"store:read",
"pricing:read",
"pricing:write"
],
"created_at": "2026-01-12T03:14:15Z",
"measurement_unit": "in",
"weight_unit": "lb",
"unit_revision": 7,
"contact_email": "hello@demosigns.example",
"website_url": "https://demosigns.example",
"primary_colour": "#1A73E8",
"use_branding_for_emails": true,
"logo_url": "https://cdn.signcustomiser.com/files/2f6c0b9e.png",
"currency_format_with_code": "£{{amount}} GBP",
"currency_format_without_code": "£{{amount}}",
"prevent_zero_price_products": true
},
"links": {
"self": "https://web.signcustomiser.com/api/v3/stores/me/logo",
"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/missing_api_key",
"title": "Missing API key",
"status": 401,
"code": "missing_api_key",
"detail": "Provide a store API key as a bearer token.",
"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 store:write scope.",
"required_scopes": [
"store:write"
],
"granted_scopes": [
"store: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/upload_already_attached",
"title": "Upload already attached",
"status": 409,
"code": "upload_already_attached",
"detail": "This upload has already been attached to a file slot. Each upload is single use: create a new upload for each assignment.",
"request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}{
"type": "https://www.signcustomiser.com/help/api/problems/upload_purpose_mismatch",
"title": "Upload purpose mismatch",
"status": 422,
"code": "upload_purpose_mismatch",
"detail": "This slot accepts uploads created with purpose store_logo, and this upload was created with purpose option_image. Create a new upload with the purpose of the slot.",
"errors": [
{
"pointer": "/upload_id",
"code": "upload_purpose_mismatch",
"detail": "The purpose of the upload is option_image.",
"allowed_values": [
"store_logo"
]
}
],
"request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}{
"type": "https://www.signcustomiser.com/help/api/problems/rate_limited",
"title": "Too many requests",
"status": 429,
"code": "rate_limited",
"detail": "You have exceeded the request limit for this API key.",
"retry_after": 60,
"request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}