View source for Create Custom List Item

== Summary ==

A list item can be created via two different methods - either as multi-part form data with a JSON file attached and the API key as a parameter, or as JSON content on it's own, with the API key supplied within the JSON.

The 'create item' method accepts an array of list items to be added to the system. If the 'update_existing' parameter is set, then any existing list items will be updated in the system. If set to false or not provided..

==== Multi Part Form Data ====
{| border="1" class="wikitable"

! Create Item
! colspan="2" | 
|-
!  URL
| colspan="2" | http://base_url/api_path/version/list/item/create
|-
! Type
| colspan="2" |POST
|-
! Params:
| api_key || required 
|-
! 
| file || required
|-
! 
| update_existing || optional (default = false)
|-
! Response
| colspan="2" | JSON
|}

==== JSON As Body ====
{| border="1" class="wikitable"
! Create Item - JSON
! colspan="2" | 
|-
!  URL
| colspan="2" | https://base_url/api_path/version/list/item/create
|-
! Type
| colspan="2" |POST
|-
! 
| JSON <br /> {key, update_existing(optional), items[]}   ||| required    
|-
! Response
| colspan="2" | JSON
|}

== JSON Contents ==

{| border="1" class="wikitable"
|+ The JSON file is passed in the post as the "file"
! colspan="3" | Standard Fields
|-
! Field
! Expected Data
! Required
|-
! list_key
| varchar(255) || 
|-
! name
| varchar(255) || &#10003;
|- 
! notes
| text ||
|-
! order_position
| int(11) ||
|-  
! external_id
| varchar(255) || 
|- 
|}

{| border="1" class="wikitable"
|+ Fields exclusive to JSON body format:
! colspan="3" | Standard Fields
|-
! Field
! Expected Data
! Required
|-
! key
| string - company api key || &#10003;
|-
! update_existing
| boolean ||
|- 
|}