Clone a promotion

POST

/api/v3/promotions/{promotionCollateralUid}/clones

const url = 'https://api.tryletterhead.com/api/v3/promotions/example/clones?api=true';
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url 'https://api.tryletterhead.com/api/v3/promotions/example/clones?api=true' \
  --header 'Authorization: Bearer <token>'

Duplicate an existing promotion (campaign, collateral, and template customization) into a new draft promotion with its own promotionCollateralUid. The clone’s fields are copied as-is; the caller edits the clone afterward with Update a promotion.

v3 endpoints expect a company API key.

Authorizations

bearerAuth

Parameters

Path Parameters

promotionCollateralUid

required

string

UUID of the promotion to clone

Query Parameters

api

required

boolean

When set to true, the endpoint accepts authorization with your API Key.

Responses

201

201 Created

application/json

object

items

object

promotionCollateralUid

string

message

string

total

integer

Example

{
  "items": {
    "promotionCollateralUid": "f7e6d5c4b3"
  },
  "message": "Promotion cloned successfully",
  "total": 1
}

Still can’t find what you need? Contact support.