---
updatedAt: 2026-04-12T09:23:16.000Z
---

# Clone the Folder

Clone a folder for a specific advertiser

> 📘 URL: POST/api/v1/folders/clone

# Request Parameters

| Parameter    | Description                                        | Type    | Required | Possible Values        |
| :----------- | :------------------------------------------------- | :------ | :------- | :--------------------- |
| advertiserId | The ID of the specific advertiser                  | integer | Y        | A valid advertisers ID |
| folderId     | ID of the folder where new folder is to be created | string  | N        | A valid folder ID      |

# Headers

| Header Name              | Description                                                                                                                                    | Required | Values                                                                                                                                           |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| Authorization            | The token will provide you the access to the API. It is same for all advertisers you access through the API.                                   | Y        | Please utilize the generated `auth_token` shared with you at the time of partner onboarding from the Getting Started Guide                       |
| Content-Type             | Format of the message body                                                                                                                     | Y        | application/json                                                                                                                                 |
| WM\_CONSUMER.ID          | Unique ID for consumer. We will provide you the consumer ID to access the API. It is same for all advertisers you access   through the API.    | Y        | Please use the generated `ConsumerId` shared with you at the time of partner onboarding. Refer to the Getting Started Guide for more information |
| WM\_SEC.AUTH\_SIGNATURE  | Signature for authentication                                                                                                                   | Y        | Use the signature generator code from Getting Started Guide to generate this value                                                               |
| WM\_SEC.KEY\_VERSION     | Key version. We will provide you with the KEY VERSION to access the API. It is same for all advertisers you access through the API.            | Y        | 1                                                                                                                                                |
| WM\_CONSUMER.intimestamp | Timestamp for  which the auth signature is generated. Use Unix epoch format for the timestamp.                                                 | Y        | Use the signature generator code from Getting Started Guide to generate this value                                                               |

## Sample Request

```
curl -X POST \
'https://developer.api.us.stg.walmart.com/api-proxy/service/display/api/v1/api/v1/folders/clone\'
--header 'Content-Type:  application/json'  \ 
--header 'Content-Type: multipart/form-data'\
--header 'Authorization: Bearer <auth_token>'
--header 'WM_SEC.AUTH_SIGNATURE: **************'  \ 
--header 'WM_SEC.KEY_VERSION: 1'  \ 
--header 'WM_CONSUMER.ID: adfwe-v23-faasd2r-afs-asdfqeff'  \ 
--header 'WM_CONSUMER.intimestamp: 1565309779'
 
--data 
{
         "advertiserId  = 1,     
         "folderId": "f02a09b2-1e3c-2g22-bf47-8a123c35002a" 
}
```

# Response

[block:parameters]
{
  "data": {
    "h-0": "Element",
    "h-1": "Description",
    "h-2": "Type",
    "0-0": "code",
    "0-1": "The response code can have following values:<ul><li>success</li><li>failure</li></ul><br>Click [here](/advertising-partners/docs/api-status-codes-and-errors)  for more information about Status Codes and Errors",
    "0-2": "string",
    "1-0": "details",
    "1-1": "Details of the error if the response code is `failure`",
    "1-2": "string",
    "2-0": "folderId",
    "2-1": "ID of the folder",
    "2-2": "string"
  },
  "cols": 3,
  "rows": 3,
  "align": [
    "left",
    "left",
    "left"
  ]
}
[/block]

## Sample Response

```
[  
    {  
        "code": "success",  
        "details": ["success"],  
        "folderId": "e02a09b2-1e3c-2g22-bf47-8a123c35002a"
    } 
]
```