Creates Songs in users account.
POSThttps://api.elvanto.com/v1/songs/create.{json|xml|php}
| Name | Type | Description |
|---|---|---|
| title Required | text | The name of the song to create |
| arrangements Required | array | At least one Arrangment object to associate with the song. Each arrangement must have a name parameter specified. You can optionally choose to create Keys associated with the arrangment using the keys parameter as well. Keys must have a name and key_starting parameter set as well. Further options for Arrangements and Keys can be found in the Arrangement Creation and Key Creation pages, although no Song or Arrangement ID is required to be sent through in this call. |
| status | integer | Whether the song is Published or Archived. 0 for published. 1 for archived. Defaults to published. |
| number | integer | CCLI Number for the song. |
| item | integer | Whether the song is considered a "Song" or an "Item" - 0 for "Song" (Default) and 1 for "Item" |
| learn | integer | Whether the song is marked as a "To Learn" song for musicians or not. 1 to indicate it is "To Learn" - Defaults to 0 |
| allow_downloads | integer | Whether the song's audio files can be downloaded or not. 1 to indicate audio files can be downloaded - Defaults to 0 |
{
"title": "10,000 Reasons (Bless the Lord)",
"arrangements": [
{
"name": "Standard",
"keys": [
{
"name": "C (Standard)",
"key_starting": "C"
},
{
"name": "F (Alt 1)",
"key_starting": "F"
},
{
"name": "G (Alt 1)",
"key_starting": "G"
}
],
"copyright": "2011 Said And Done Music (Admin. by Crossroad Distributors Pty. Ltd.)",
"sequence": [
"Chorus 1",
"Verse 1",
"Verse 2",
"Verse 3",
"Misc 1"
],
"minutes": 2,
"seconds": 17,
"bpm": 72.5,
"chord_chart_key": "C",
"chord_chart": "ChordPro Formatted\\nChord Chart"
}
],
"learn": 1,
"allow_downloads": 1,
"number": "6016351",
"item": 0
}title=10,000+Reasons+(Bless+the+Lord)&arrangements[0][name]=Standard&arrangements[0][keys][0][name]=C+(Standard)&arrangements[0][keys][0][key_starting]=C&arrangements[0][keys][1][name]=F+(Alt+1)&arrangements[0][keys][1][key_starting]=F&arrangements[0][keys][2][name]=G+(Alt+1)&arrangements[0][keys][2][key_starting]=G&arrangements[0][copyright]=2011+Said+And+Done+Music+(Admin.+by+Crossroad+Distributors+Pty.+Ltd.)&arrangements[0][sequence][0]=Chorus+1&arrangements[0][sequence][1]=Verse+1&arrangements[0][sequence][2]=Verse+2&arrangements[0][sequence][3]=Verse+3&arrangements[0][sequence][4]=Misc+1&arrangements[0][minutes]=2&arrangements[0][seconds]=17&arrangements[0][bpm]=72.5&arrangements[0][chord_chart_key]=C&arrangements[0][chord_chart]=ChordPro+Formatted\nChord+Chart&learn=1&allow_downloads=1&number=6016351&item=0{
"generated_in": "0.021",
"status": "ok",
"song": {
"id": "e453b1a7-f681-48e8-97b6-e3a6c2b6a8c6",
"arrangements": [
{
"id": "0b19c2ec-f1db-4ebb-bf3c-429d36af12e9"
}
]
}
}<?xml version="1.0" encoding="UTF-8"?>
<rsp generated_in="0.021" status="ok">
<song id="e453b1a7-f681-48e8-97b6-e3a6c2b6a8c6">
<arrangements id="0b19c2ec-f1db-4ebb-bf3c-429d36af12e9">
<keys id="8f438648-2cce-4205-ac73-47a42c9eb397"/>
</arrangements>
</song>
</rsp>
stdClass Object
(
[generated_in] => 0.021
[status] => ok
[song] => stdClass Object
(
[id] => e453b1a7-f681-48e8-97b6-e3a6c2b6a8c6
[arrangements] => stdClass Object
(
[0] => stdClass Object
(
[id] => 0b19c2ec-f1db-4ebb-bf3c-429d36af12e9
)
)
)
)
Please see our response status codes documentation for details of potential error responses for any API request.