---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.ru/dev/direct/doc/en/creatives/add.md
  - https://yandex.ru/dev/direct/doc/ru/creatives/add.md
  - href: en/creatives/add.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: en/ref-v5/creatives/add.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/direct/doc/en/llms.txt

# add

Builds creatives for video extensions based on the video ID received from [AdVideos](https://yandex.ru/dev/direct/doc/en/advideos/advideos.md).

## Learn more

- [Creative](https://yandex.com/dev/direct/doc/dg/objects/creative.html)
- [How the "add" method works](https://yandex.com/dev/direct/doc/dg/best-practice/modify.html)
- [How to handle errors](https://yandex.com/dev/direct/doc/en/concepts/errors)


## Restrictions {#restrictions}

Maximum of 10 videos per method call.


## Request {#input}

Request structure in JSON format:

```javascript
{
  "method": "add",
  "params" : { /* required */
    "Creatives" : [{ /* required */
      "VideoExtensionCreative" : { /* required */
        "VideoId" : (string) /* required */
        }
    }, ... ]
  }
}
```


#|
||
**Parameter** 
|
**Type** 
|
**Description** 
|
**Required**
||
||
**params structure (for JSON) / AddRequest structure (for SOAP)**
|
>
|
>
|
>
||
||
`Creatives`
|
array of CreativeAddItem
|
Creatives to add (a maximum of 10).
|
Yes
||
||
**CreativeAddItem structure**
|
>
|
>
|
>
||
||
`VideoExtensionCreative`
|
array of VideoExtensionCreativeAddItem
|
Settings of a [creative for video extensions](https://yandex.com/dev/direct/doc/dg/objects/creative.html#types).
|
Yes
||
||
**VideoExtensionCreativeAddItem structure**
|
>
|
>
|
>
||
||
`VideoId`
|
string
|
ID of the video.
|
Yes
||
|# 


## Response {#output}

Response structure in JSON format:

```javascript
{
  "result" : { /* required */
    "AddResults" : [{
      "Warnings" : [{
        "Code" : (integer) /* required */,
        "Message" : (string) /* required */,
        "Details" : (string)
      }, ... ],
      "Errors" : [{
        "Code" : (integer) /* required */,
        "Message" : (string) /* required */,
        "Details" : (string)
      }, ... ],
      "Id" : (long)
    }, ... ]
  }
}
```


#|
||
**Parameter** 
|
**Type** 
|
**Description** 
||
||
**result structure (for JSON) / AddResponse structure (for SOAP)**
|
>
|
>
||
||
`AddResults`
|
array
|
Results of adding creatives.
||
||
**AddResults structure**
|
>
|
>
||
||
`Warnings`
|
array of ExceptionNotification
|
Warnings that occurred during the operation.
||
||
`Errors`
|
array of ExceptionNotification
|
Array of errors that occured when adding videos to the upload queue.
||
||
`Id`
|
long
|
The ID of the newly built creative. Returned if there aren't any errors. See the section [Operations on object arrays](https://yandex.com/dev/direct/doc/dg/best-practice/modify.html).
||
||
**Warnings, Errors structure**
|
>
|
>
||
||
`Code`
|
int
|
Error code.
||
||
`Message`
|
string
|
Textual message about the error.
||
||
`Details`
|
string
|
Detailed description of the reason for the error.
||
|#