API Reference
  1. One Church Software API
  2. Songs

Create song

post
https://{tenant}.onechurchsoftware.com/api/songs

Create a new song along with its default arrangement. The song title must be unique. Returns the created song.

Required permission: Full Write Songs

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

The details of the song

string | null
required

The title of the song. Must be unique.

default
object | null
required

The song's default arrangement, created along with the song. Required when creating a song; ignored when updating one (manage arrangements through the arrangement endpoints). When name is omitted it defaults to "Default Arrangement".

string | null

The CCLI number of the song.

string | null

Notes about the song.

string | null

The authors of the song.

string | null

The copyright statement for the song.

category
object | null

The category the song is organized under. Provide either id or code when writing. Values come from /api/property_values/song_categories/values.

files
array of objects | null

Files and links attached to the song itself rather than to a specific arrangement or key.

files
Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

401

Authentication is required, or the Ocs-Api-Key header is missing or invalid.

Updated about 2 months ago

Did this page help you?
Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
text/plain
application/json
text/json

Updated about 2 months ago

Did this page help you?