Pinterest
Pinterest pin scheduling to the right board
Every pin needs a board, a strong title and a link that works. Postwoo discovers your boards, makes you pick one before scheduling, and publishes through Pinterest's official API v5 — then reports impressions, saves and outbound clicks as Pinterest defines them.
What agencies use it for
- Image, carousel (2–5 images) and video pins with titles and alt text
- Pick the board per pin from the composer
- Edit a pin's title, description or link after it is live
- Impressions, saves, pin clicks and outbound clicks per day
Capability matrix
Exactly what Pinterest allows
Live from the integration itself. Statuses move from pending verification to supported only after an end-to-end check with approved credentials.
OAuth connectionPinterest OAuth (client secret via HTTP Basic on /v5/oauth/token). Access tokens last ~30 days, refresh tokens ~1 year. Apps start in trial access and need standard access review for real users.pending
Account discoveryGET /v5/user_account — one Pinterest account (business or personal) per connection.pending
Location discoveryBoards (GET /v5/boards, bookmark pagination) are exposed as locations (kind=board). A pin requires a board, so pre-flight demands one.pending
Publish text postsPinterest has no text-only pins; every pin needs an image or a video.not possible
Publish a single imagePOST /v5/pins with media_source {source_type: image_url} + board_id, title (≤100), description (≤800), link, alt_text (≤500).pending
Publish multiple imagesCarousel pins via media_source {source_type: multiple_image_urls, items: 2–5}.pending
Publish videoPOST /v5/media → multipart upload to upload_url → poll GET /v5/media/{id} until succeeded → POST /v5/pins with {source_type: video_id, media_id, cover_image_url | cover_image_key_frame_time}.pending
Attach a linkThe pin `link` field (destination URL). Pinterest may hold pins with new domains for review.pending
Call-to-action buttonNo call-to-action buttons on organic pins.not possible
Native platform schedulingThe public API has no scheduled publish time; Postwoo schedules and publishes at the right time.not possible
Delete postsDELETE /v5/pins/{id}.pending
Edit published postsPATCH /v5/pins/{id} (title, description, link, alt_text, board_id); media cannot be changed.pending
Direct media uploadVideo is uploaded directly (multipart to Pinterest's upload_url); images are fetched by Pinterest from a public URL.pending
Account-level analyticsGET /v5/user_account/analytics?start_date&end_date&metric_types=IMPRESSION,ENGAGEMENT,PIN_CLICK,OUTBOUND_CLICK,SAVE — daily values; days the API omits are marked unavailable. Business accounts only.pending
Post-level analyticsGET /v5/pins/{id}/analytics?metric_types=IMPRESSION,SAVE,PIN_CLICK,OUTBOUND_CLICK,VIDEO_MRC_VIEW — daily + lifetime shapes.pending
Read reviewsPinterest has no reviews.not possible
Reply to reviewsPinterest has no reviews.not possible
Delete review repliesPinterest has no reviews.not possible
Real-time webhooksPinterest API v5 offers no webhooks for organic pins.not possible
Token & permission healthGET /v5/user_account probe + scope check.pending
Read business profileBusiness profile management (hours, Q&A, profile photos) is only implemented for Google Business Profile in Postwoo.not possible
Update opening hoursBusiness profile management (hours, Q&A, profile photos) is only implemented for Google Business Profile in Postwoo.not possible
Read questions & answersBusiness profile management (hours, Q&A, profile photos) is only implemented for Google Business Profile in Postwoo.not possible
Answer questionsBusiness profile management (hours, Q&A, profile photos) is only implemented for Google Business Profile in Postwoo.not possible
Upload profile photosBusiness profile management (hours, Q&A, profile photos) is only implemented for Google Business Profile in Postwoo.not possible
Hashtag lookupHashtag lookup uses Instagram's official hashtag search; Postwoo does not implement it for this platform.not possible
Post a first commentAutomatic first comments are only implemented for Instagram in Postwoo.not possible
Read commentsThe social inbox does not read, answer or moderate comments on this platform (no official comment API Postwoo implements here).not possible
Reply to commentsThe social inbox does not read, answer or moderate comments on this platform (no official comment API Postwoo implements here).not possible
Hide commentsThe social inbox does not read, answer or moderate comments on this platform (no official comment API Postwoo implements here).not possible
Read direct messagesDirect messages are only implemented for Facebook Pages and Instagram (Meta Messenger Platform, 24-hour messaging window).not possible
Reply to direct messagesDirect messages are only implemented for Facebook Pages and Instagram (Meta Messenger Platform, 24-hour messaging window).not possible
Image alt textW14: pin alt_text (≤500) from the first image's alt text or the per-target option. From memory, not verified live.pending
Custom video coverVideo pins: media_source.cover_image_url (the cover chosen in the video editor, or the first attached image) or cover_image_key_frame_time. Unverified.pending
Limits
Platform limits we enforce before you schedule
The composer checks these for every target so a post is never queued only to fail later.
Text length800 characters
Images per post5
Videos per post1
Image typesjpeg, png
Mediarequired
- Every pin needs a board: pick one in the composer (boards are discovered as locations) or set platform option board_id.
- One pin per API call: title ≤100 characters, description (the post body) ≤800, alt text ≤500, one destination link.
- Images: JPEG or PNG, 2:3 aspect ratio recommended (1000×1500 px), ≤20 MB (assumption). 2–5 images become a carousel pin.
- Video: MP4/MOV, 4–15 minutes max depending on account, ≤2 GB; a cover image (first attached image) or key-frame time is used as the thumbnail. Video is uploaded directly and processed asynchronously.
- Images are fetched by Pinterest from a public HTTPS URL (APP_URL / S3).
- Trial-access apps must use the sandbox host (PINTEREST_API_BASE=https://api-sandbox.pinterest.com) and can only pin to their own test accounts.
Access
What the platform requires
- A Pinterest developer app (developers.pinterest.com) with the redirect URI …/oauth/pinterest/callback and the scopes boards:read, boards:write, pins:read, pins:write, user_accounts:read.
- New apps have *trial* access: limited to the sandbox API (https://api-sandbox.pinterest.com) and the developer's own account. Request *standard* access (app review with a demo of the Postwoo flow) before connecting client accounts; then set PINTEREST_API_BASE=https://api.pinterest.com.
- Account analytics require a Pinterest business account; pin analytics are only returned for pins owned by the connected account.
- Access tokens last about 30 days and are refreshed with the refresh token (valid about one year); refresh_token_expires_in is honoured when present.
- Rate limits are per app and endpoint (Pinterest documents roughly 1,000 calls per minute for most endpoints — assumption); Postwoo paces at 120 calls per minute per connection.
- Images are fetched by Pinterest from a public HTTPS URL, so APP_URL or S3 must be reachable from the internet.
Postwoo handles the app side. You connect with an account that has the right role on the platform.
Questions, answered honestly
Why does Postwoo ask me to choose a board?
Pinterest requires every pin to belong to a board. Postwoo lists your boards when you connect and checks that one is selected before the post can be scheduled.
Do I need a Pinterest business account?
Publishing works with any account. Account analytics are only available for business accounts, so Postwoo marks them unavailable for personal ones instead of showing zeros.
Why can only some people connect Pinterest right now?
New Pinterest apps start with trial access, which only works for the developer's own test account. Once Pinterest grants standard access, any client can connect.
Other integrations
Google Business ProfileFacebook PagesInstagramLinkedInYouTubeTikTokThreadsBluesky
Ready to woo your clients?
Start free, connect a Google Business Profile, and see real reviews and metrics in the feed within minutes.