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 qrCodeId of the record you are targeting.

Base URL

EnvironmentURL
Productionhttps://production-api.shoutaboutus.com
Developmenthttps://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_id must sit inside your own account tree.

Rate limit

  • No rate limit.

Path parameters

ParameterTypeRequiredDescription
qrCodeIdintegerRequiredDigits only.

Request body

  • Body (all optional — overrides only):
FieldTypeRequiredDescription
namestringoptionalmax 255; defaults to "<source> (Copy)"
store_idintegeroptionalMust be an existing location inside your own account tree
destination_typestringoptionalone of landing_page, review_site, custom_url
landing_page_idintegeroptionalMust be an existing landing-page template
review_site_idintegeroptionalMust be an existing review site
destination_urlstringoptional
customizationarrayoptionalnullable 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 with company:id,name, store:id,name, landingPage:id, reviewSite:id loaded and qr_code_image_url appended.
  • data.message (string) — "QR code duplicated successfully".

201 Created · 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

StatusMeaning
401The bearer token is missing, expired or invalid
404Returned if outside the account company
422The request failed validation — the response names the fields
500Unexpected 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"}'

Did this page help you?