Duplicate QR code
Overview
Create a copy of an existing QR code with optional field overrides; the source must belong to the authenticated account-user. The clone defaults its name to "<source name> (Copy)" and copies the source's destination fields/customization where not overridden. It then regenerates its own destination URL and QR image.
Prerequisites
- A bearer token. Callable with Account tokens.
- The
qrCodeIdof the record you are targeting.
Base URL
| Environment | URL |
|---|---|
| Production | https://production-api.shoutaboutus.com |
| Development | https://development-api.shoutaboutus.com |
Endpoint
POST /api/v1/qr-codes/{qrCodeId}/duplicate
Authentication
-
Requires a bearer token in the
Authorization: Bearer <bearer-token>header. -
Who can call it: Account tokens.
-
Authentication (404 if outside the account company).
-
The clone inherits the source's
company_id. -
An overriding
store_idmust sit inside your own account tree.
Rate limit
- No rate limit.
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
qrCodeId | integer | Required | Digits only. |
Request body
- Body (all optional — overrides only):
| Field | Type | Required | Description |
|---|---|---|---|
name | string | optional | max 255; defaults to "<source> (Copy)" |
store_id | integer | optional | Must be an existing location inside your own account tree |
destination_type | string | optional | one of landing_page, review_site, custom_url |
landing_page_id | integer | optional | Must be an existing landing-page template |
review_site_id | integer | optional | Must be an existing review site |
destination_url | string | optional | — |
customization | array | optional | nullable JSON object |
{
"name": "Front desk (Copy)",
"destination_type": "custom_url",
"destination_url": "https://example.com/promo"
}Response
data.status(string) —"success".data.data(object) — the new QrCode withcompany:id,name,store:id,name,landingPage:id,reviewSite:idloaded andqr_code_image_urlappended.data.message(string) —"QR code duplicated successfully".
201 Created · 201
201{
"data": {
"status": "success",
"data": {
"id": 201,
"name": "Front desk (Copy)",
"company_id": 412,
"store_id": 8748,
"destination_type": "custom_url",
"destination_url": "https://example.com/promo",
"qr_code_image_path": "qr-codes/def.png",
"qr_code_image_url": "https://s3.example.com/qr-codes/def.png"
},
"message": "QR code duplicated successfully"
}
}Errors
| Status | Meaning |
|---|---|
401 | The bearer token is missing, expired or invalid |
404 | Returned if outside the account company |
422 | The request failed validation — the response names the fields |
500 | Unexpected server error |
Example request
curl --request POST \
--url "https://production-api.shoutaboutus.com/api/v1/qr-codes/123/duplicate" \
--header 'Authorization: Bearer <bearer-token>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{"name": "Front desk (Copy)", "destination_type": "custom_url", "destination_url": "https://example.com/promo"}'Updated 10 days ago
Did this page help you?
