Post to Pinterest via API — Schedule, Publish, Analyze

Connecting your Pinterest account to CodivUpload takes under a minute. Navigate to the Integrations page in your dashboard and click Connect Pinterest. You'll be redirected to Pinterest's OAuth consent screen, where you grant CodivUpload permission to create pins and read your board list. Once authorized, your Pinterest profile and all its boards are synced to your account.

Select your boards: After connecting, your boards appear in the platform override panel when composing a post. Choose a target board by name or ID — CodivUpload resolves both. If you manage multiple Pinterest accounts (e.g., personal and business), connect each one separately and switch between them using the profile selector.

Pin your first content: Create a new post in the dashboard or via the API, select "pinterest" as a platform, attach an image or video, and set the pinterest_board_id override. Add a destination link with pinterest_link to drive traffic back to your site. The pin is published immediately or at your scheduled time.

CodivUpload stores your Pinterest access token encrypted at rest and refreshes it automatically before expiry. You won't need to re-authorize unless you explicitly revoke access from Pinterest's connected apps settings.

Pinterest is a visual search engine, not just a social network. Optimizing your pins for search discoverability directly impacts impressions and click-throughs. Here's what matters.

Pin titles (100 characters max): Pinterest displays your pin title prominently in search results and closeup views. Front-load the most important keyword. Instead of "Our Latest Collection", write "Minimalist Living Room Ideas for Small Apartments". Specific, descriptive titles get 3-5x more saves than generic ones because Pinterest's search algorithm indexes every word.

Pin descriptions (500 characters max): Descriptions are your SEO playground on Pinterest. Write natural-language sentences that include relevant keywords — not comma-separated keyword lists. The description should explain what the pin leads to and why someone should save or click it. Use the full description field in the CodivUpload API to set this programmatically.

2:3 aspect ratio (1000x1500px): Pinterest's feed layout is vertically oriented. Images with a 2:3 aspect ratio take up the most visual space in the feed and perform best. Square images (1:1) get cropped awkwardly, and horizontal images shrink to near-invisibility. For video pins, the same vertical format applies — shoot or crop to 1080x1920 or 1000x1500.

Board strategy: Organize your boards by topic, not by campaign. A board named "Home Office Setup Ideas" performs better than "Q2 Campaign" because users browse boards by interest. Each board's title and description are indexed by Pinterest search. Pin consistently to each board — 3 to 5 new pins per board per week keeps the board active in recommendation algorithms.

Rich pins: If your website has Open Graph or Schema.org markup, Pinterest can pull in enhanced metadata automatically — product prices, article titles, recipe ingredients. This makes your pins more informative in the feed without any extra API parameters.

Alt text for SEO and accessibility: The pinterest_alt_text field serves double duty: screen readers use it for accessibility, and Pinterest's visual search engine uses it as an additional ranking signal. Describe what's in the image concretely — "white linen sofa in a sunlit living room with oak flooring" beats "beautiful room".