create_collection

Create a collection on the account: a YouTube playlist or a Pinterest board. Needs the manage permission. Also available as the MCP tool create_collection.

POST

https://mixetape.com/api/v1/tools/create_collection

View as Markdown

Authorisation

apiKeyHTTPrequired

Request bodyJSONrequired

accountIdstringrequired
mixetape account id (list_accounts)
titlestringrequired
descriptionoptionalstring
visibilityoptionalpublicorunlistedorprivate

Returns

200

The tool's result.

JSON

resultunknownrequired
What the tool returns

400

The request is invalid; error says why.

JSON

errorstringrequired
What went wrong, in plain words

401

No valid API key.

JSON

errorstringrequired
What went wrong, in plain words

403

The key lacks the permission this needs.

JSON

errorstringrequired
What went wrong, in plain words

404

Not found, or not yours.

JSON

errorstringrequired
What went wrong, in plain words

create_collection

curl --request POST \
  --url https://mixetape.com/api/v1/tools/create_collection \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "accountId": "string",
  "title": "string",
  "description": "string",
  "visibility": "public"
}
'

const url = 'https://mixetape.com/api/v1/tools/create_collection';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json', Authorization: 'Bearer <token>'},
  body: JSON.stringify({
    accountId: 'string',
    title: 'string',
    description: 'string',
    visibility: 'public'
  })
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

import requests

url = "https://mixetape.com/api/v1/tools/create_collection"

payload = {
    "accountId": "string",
    "title": "string",
    "description": "string",
    "visibility": "public"
}
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer <token>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

Response example

{
  "result": null
}

{
  "error": "string"
}

{
  "error": "string"
}

{
  "error": "string"
}

{
  "error": "string"
}