marketing
Pinterest CLI for Headless Automation
Use the Pinterest CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.
7 functions 6 read 1 write Manual OAuth token auth
Pinterest CLI for Headless Automation
Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.
Use headless automation when another tool needs a stable local command surface. The Pinterest CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# Pinterest CLI for Headless Automation
kosmokrator integrations:configure pinterest --set access_token="$PINTEREST_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmo integrations:call pinterest.pinterest_create_pin '{"boardId":"example_boardId","title":"example_title","description":"example_description","mediaSource":"example_mediaSource","imageUrl":"example_imageUrl","link":"example_link"}' --json Discovery Before Execution
Agents and scripts can inspect Pinterest docs and schemas before choosing a function.
kosmo integrations:docs pinterest --json
kosmo integrations:docs pinterest.pinterest_create_pin --json
kosmo integrations:schema pinterest.pinterest_create_pin --json
kosmo integrations:search "Pinterest" --json
kosmo integrations:list --json Useful Pinterest CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
pinterest.pinterest_create_pin | Write | boardId, title, description, mediaSource, imageUrl, link | Create a new pin on a Pinterest board. Provide the board ID, title, description, and image URL. Optionally include a destination link. |
pinterest.pinterest_get_board | Read | boardId | Get details of a specific Pinterest board by its ID. Returns the board name, description, pin count, and privacy settings. |
pinterest.pinterest_get_current_user | Read | none | Get the currently authenticated Pinterest user profile. Returns the username, account type, and profile image. |
pinterest.pinterest_get_pin | Read | pinId | Get details of a specific Pinterest pin by its ID. Returns the pin title, description, image, board, and link. |
pinterest.pinterest_list_boards | Read | bookmark, pageSize | List boards for the authenticated Pinterest user. Supports pagination with bookmark cursor and page size. Returns board IDs, names, descriptions, and pin counts. |
pinterest.pinterest_list_campaigns | Read | adAccountId, bookmark, pageSize | List ad campaigns for a Pinterest ad account. Requires an ad account ID. Supports pagination with bookmark cursor and page size. |
pinterest.pinterest_list_pins | Read | bookmark, pageSize | List pins for the authenticated Pinterest user. Supports pagination with bookmark cursor and page size. Returns pin IDs, titles, descriptions, and media. |
Automation Notes
- Use
--jsonfor machine-readable output. - Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
- Configure read/write policy before unattended runs; use
--forceonly for trusted automation. - Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.