![\"\"/](\"//assets.adnuntius.com/aO59MDnCKaLBQNA0G0DUCc7nj8wJA0e149OPTkQCww8.jpg\")
",
"type": "INTERNAL",
"url": "/api/v1/creatives/7007clfzcm78jkjg"
}
],
"totalCount": 1
}
```
## POST
Post object contains the following keys:
| Name | Required | Restriction | Description |
| ---------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| name | Yes | String | The name of the creative. |
| description | | String | The description for the creative. |
| userState | | `NOT_READY`, `REQUIRES_REVIEW`, `APPROVED`, `REJECTED`, `PAUSED` | The state of the creative. Defaults to `APPROVED` if not specified. |
| rejectedReason | No\* | `ADULT_CONTENT`, `BLANK_CONTENT`, `MALFORMED_CLICK_THROUGH`, `DRUG_RELATED_CONTENT`, `WEAPON_RELATED_CONTENT`, `ABUSIVE_CONTENT`, `HATE_SPEECH_CONTENT`, `LANDING_PAGE_REJECTED`, `OFFENSIVE_CONTENT`, `UNACCEPTABLE_VISUAL_EFFECTS`, `DECEPTIVE_CONTENT`, `GAMBLING_CONTENT`, `PROHIBITED_ELECTION_RELATED_CONTENT`, `SHOCKING_CONTENT`, `MALWARE_CONTENT` | (\*required if `userState` is `REJECTED`) The reason for the creative being in the `REJECTED` state. |
| layout | Yes | String | The layout ID to be associated with the creative. |
| dimensionType | | `FIXED`, `FLEXIBLE`, `FIXED_WIDTH`, `FIXED_HEIGHT` | The library creative dimension type. Defaults to `FIXED` if not specified. |
| width | No\* | Int | (\*required if dimensionType is `FIXED` or `FIXED_WIDTH`) The width of the creative. |
| height | No\* | Int | (\*required if dimensionType is `FIXED` or `FIXED_HEIGHT`) The height of the creative. |
| targeting | | Object | The targeting for the creative. |
| impressionTrackingUrls | | Array | The impression tracking URL for the creative. |
| thirdPartyContent | | Object | The third party content. |
| type | | `INTERNAL`, `EXTERNAL` | The type of creative. Defaults to `INTERNAL` if not specified. |
| sponsorshipPercentage | | Number | The sponsorship percentage for the creative. |
| externalDemandSource | | String | The external demand source ID to be associated with the creative. |
| externalAdUnit | | Array | The external ad unit IDs to be associcated with the creative. |
| copyrightStatus | | `UNSPECIFIED`, `ADVERTISER_CONFIRMED`, `ADVERTISER_UNCONFIRMED` | The copyright status. Defaults to `UNSPECIFIED` if not specified. |
| source | | `SELF_SERVICE`, `MARKETPLACE`, `DIRECT` | The source of the creative. Defaults to `DIRECT` if not specified. |
| verifiedSafe | Yes | Boolean | The creative is verified to be safe. |
| libraryCreative | | String | The library creative ID to be associated with the creative. If the library creative is specified then `layout`, `dimensionType`, `width`, `height`, `layoutParameters`, `targeting`, `thirdPartyContent`, `copyrightStatus`, `source`, `verifiedSafe` fields will be overwritten with values from the library creative unless specified in `overrideFields` |
| overrideFields | | Array | Override the fields if `libraryCreative` is specified. The following fields are overrideable: `dimensionType`, `width`, `height`, `layoutParameters`, `targeting`, `copyrightStatus`, `source`, `verifiedSafe` |
Creative ID can be set to whatever string value the user would like as long as it is unique within the network.
Example POST request: `{id}` will be required when posting to the API.
```http
POST https://api.adnuntius.com/api/v1/creatives/{id}
```
Example post body:
```javascript
{
"constraintsToAssets": {
"image1": "asset_1",
"image2": {
"id": "asset_2"
},
"image3": null
},
"constraintsToText": {
"headline": "Man bites Dog!",
"content": "Click here..."
},
"constraintsToUrls": {
"destinationUrl": "www.example.com"
},
"description": "The description for the creative",
"height": 300,
"impressionTrackingUrls": [ "http://imp.tradedoubler.com/imp?type(inv)g(20367306)a(2095715)" ],
"layout": "layout_1",
"lineItem": "lineitem_1",
"name": "My First Creative",
"userState": "REQUIRES_REVIEW",
"width": 200,
"type": "INTERNAL"
}
```
example POST response
```javascript
{
"lineItem": {
"id": "lineitem_1",
"url": "/api/v1/lineitems/lineitem_1",
"name": "My Line Item"
},
"constraintsToAssets": {
"image1": {
"id": "asset_1",
"url": "/api/v1/assets/creative_1/asset_1"
},
"image2": {
"id": "asset_2",
"url": "/api/v1/assets/creative_1/asset_2"
},
"image3": null
},
"constraintsToText": {
"headline": "Man bites Dog!",
"content": "Click here..."
},
"constraintsToUrls": {
"destinationUrl": "www.example.com"
},
"thirdPartyContent": {},
"createTime": "2016-01-01T10:20:30Z",
"createUser": {
"id": "create_user",
"url": "/api/v1/users/create_user",
"name": "Alice"
},
"description": "The description for the creative",
"height": 300,
"id": "creative_1",
"impressionTrackingUrls": [ "http://imp.tradedoubler.com/imp?type(inv)g(20367306)a(2095715)" ],
"layout": {
"id": "layout_1",
"url": "/api/v1/layouts/layout_1",
"name": "My Layout"
},
"name": "My First Creative",
"network": {
"id": "network_1",
"url": "/api/v1/networks/network_1"
},
"objectState": "ACTIVE",
"targeting": {
"adUnitMatchingLabelTargets": [],
"adUnitTarget": {
"adUnits": []
},
"categoryTargets": [],
"dateTarget": {
"dateRanges": [],
"timeZoneSetting": "SYSTEM"
},
"deviceTargets": [],
"geospatialTargets": [],
"keyValueTargets": [],
"keywordTargets": [],
"namedLocationTarget": {
"locations": []
},
"retargetingTargets": [],
"siteTarget":{
"sites": []
},
"userSegmentTargets": [],
"dayPartingTargets": [],
"ipAddressTarget": {
"addresses":[]
}
},
"updateTime": "2016-01-11T10:20:30Z",
"updateUser": {
"id": "update_user",
"url": "/api/v1/users/update_user",
"name": "Bob"
},
"userState": "REQUIRES_REVIEW",
"url": "/api/v1/creatives/creative_1",
"validationWarnings": [],
"width": 200,
"type": "INTERNAL"
}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.adnuntius.com/adnuntius-advertising/admin-api/endpoints/creatives.md?ask=