add_to_collection

Add a post that is on the platform to a collection (YouTube playlist, or save a Pin to another Pinterest board). position 0 puts it first; omitted puts it last. For a post still 'scheduled', set metadata.playlistIds instead. Needs the manage permission. Also available as the MCP tool add_to_collection.

POST

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

View as Markdown

Authorisation

apiKeyHTTPrequired

Request bodyJSONrequired

idstringrequired
mixetape post id (list_posts)
collectionIdstringrequired
positionoptionalnumber

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

curl --request POST \ --url https://mixetape.com/api/v1/tools/add_to_collection \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "id": "string", "collectionId": "string", "position": 0 } '