/servlet/control/api/sizes/create
Allows you to create a new size with the specified properties.
/servlet/control/api/sizes/create
| Parameter Name | Parameter Type | Required? | Example Value | Default Value | Validation Rules (If Applicable) |
|---|---|---|---|---|---|
| secret | String | Yes | a78bf24c5a23581aceba1c5f51ac4cad | (None) | Must be a String containing no more than 32 characters |
| output | String | No | xml | xml | Must be a String equal to either json or xml |
| Parameter Name | Parameter Type | Required? | Example Value | Default Value | Validation Rules (If Applicable) |
| name | String | Yes | Jumbo Banner | (None) | Must be a String containing no more than 80 characters |
| width | Integer | Yes | 728 | (None) | Must be an Integer between 1 and 9,999 |
| height | Integer | Yes | 90 | (None) | Must be an Integer between 1 and 9,999 |
| notes | String | No | N/A | (None) | Must be a String containing no more than 65,535 characters |
| Parameter Name | Parameter Type | Required? | Example Value | Default Value | Validation Rules (If Applicable) |
| default_image | URL | Yes | http://example.com/banner.gif | (None) | Must be a HTTP or HTTPS URL containing no more than 1,024 characters |
| default_redirect | URL | Yes | http://example.com/ | (None) | Must be a HTTP or HTTPS URL containing no more than 1,024 characters |
| default_border | Integer | No | 0 | 0 | Must be an Integer between 0 and 999 |
| default_hspace | Integer | No | 0 | 0 | Must be an Integer between 0 and 999 |
| default_vspace | Integer | No | 0 | 0 | Must be an Integer between 0 and 999 |
| default_align | String | No | right | (None) |
Must be a String equal to one of the following values:
|
| default_target | String | Yes | _blank | _blank | Must be a String containing no more than 16 characters |
| default_alt | String | No | Click Here! | Click Here! | Must be a String containing no more than 128 characters |
| default_textlink | String | No | This text will appear as a link below the banner. | (None) | Must be a String containing no more than 128 characters |
| default_html | HTML | No | N/A | (None) | Must be HTML or XHTML code containing no more than 65,535 characters |
| Parameter Name | Parameter Type | Required? | Example Value | Default Value | Validation Rules (If Applicable) |
| compatible | CSV Integer | No | N/A | (None) | This multiple value parameter can be in the form of either a single CSV parameter value or multiple parameter values and must contain the ID# of an existing size(s) |
/servlet/control/api/sizes/create?secret=(key)&name=Jumbo+Banner&width=728&height=90&default_image=http://example.com/banner.gif&default_redirect=http://example.com/&default_target=_blank
<id>123</id>
/servlet/control/api/sizes/create?secret=(key)&output=json&name=Jumbo+Banner&width=728&height=90&default_image=http://example.com/banner.gif&default_redirect=http://example.com/&default_target=_blank
{ "id" : 123 }