save_pins_to_board
Use this when the user wants existing Pinterest Pins added to one of their boards — "add these to my board", "fill this board with X", "build me a board about X". Saves Pins that already exist on Pinterest onto the board (a repin); it does not create new Pins from the user's own images, which is create_post.
Billing: saving onto a board create_board made in the last hour is free for up to 50 Pins in total, across calls. Any other save is billed like scheduling a Pin: one credit per saved Pin on credit plans, or one post from the plan's post allowance. A save the plan cannot cover is refused with nothing saved; call get_account_usage first when saving many Pins to an existing board.
This is the last step of build-a-board-about-X: create_board → get_recommended_pins for that new boardId → save_pins_to_board with the ids the user picked. Show the user the recommended Pins and let them choose before calling this, unless they have already said to add everything.
Returns savedCount and failedCount. A Pin that could not be saved — usually deleted, or a boardId that does not exist — is counted in failedCount rather than failing the call, so a result of savedCount 0 is a complete failure even though the call succeeded. Which Pins failed is not reported, so re-read the board if the user needs to know.
Do NOT retry this call after a timeout or an unclear result. Pinterest treats a repeat save as a second Pin, so a retry duplicates whatever already landed; re-read the board instead. For the same reason, do not pass the same Pin id twice in one call. Re-running get_recommended_pins is safe — it excludes Pins already saved to the board — so use it, not a blind retry, to find what is still missing. Keep batches to a few dozen ids — a large batch of slow saves can still time out with a 504, and saves already in flight are not cancelled, so re-read the board rather than retrying blind. If the user did not say which Pinterest account to use and list_accounts returns more than one, ask the user which account to use before calling this — do not choose for them.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pinIds | Yes | Numeric Pinterest Pin IDs to save, e.g. the ids from get_recommended_pins — never a Pin URL. Must not contain duplicates. | |
| boardId | Yes | Numeric Pinterest board ID from list_boards — never a board name or URL | |
| accountId | Yes | Numeric Tailwind account ID returned by list_accounts |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| savedCount | Yes | Pins saved onto the board | |
| failedCount | Yes | Pins that could not be saved. Which ones is not reported. |