Pinterest API

Pinterest API for posting and scheduling without the board and visual campaign overhead

Built for commerce, creator, and content tools that publish evergreen visual campaigns. Add Pinterest publishing with one API for scheduling, media, status, and reporting workflows.

Last updated: July 2026

One API key. No per-account fees. 15 platforms.

API key authScheduled publishing15 platforms
Quick start
API request
1await fetch("https://api.bundle.social/api/v1/post", {2  method: "POST",3  headers: {4    "x-api-key": process.env.BUNDLE_SOCIAL_API_KEY,5    "Content-Type": "application/json"6  },7  body: JSON.stringify({8    teamId: "team_123",9    title: "New arrival Pin",10    postDate: "2026-05-14T10:00:00.000Z",11    status: "SCHEDULED",12    socialAccountTypes: ["PINTEREST"],13    data: {14      PINTEREST: {15        boardId: "board_inspiration_feed",16        link: "https://example.com/products/new-arrival",17        altText: "New arrival product shot on white background",18        description: "Our latest drop - tap to shop."19      }20    }21  })22});
Official APIs500k+ connected accountsDirect engineer support

Building directly on Pinterest API

Pinterest publishing depends on boards, media quality, links, descriptions, and account permissions.
Visual teams usually need Pinterest planned with Instagram, TikTok, and Facebook, not off to the side.
Analytics and post history get messy when Pinterest lives in a separate tool.

What bundle.social handles

Create Pins with board, link, alt text, and description fields in one social workflow.
Schedule Pinterest content without building a second calendar just for visual campaigns.
Use analytics and post history for Pinterest when the native API and account allow them.

Pinterest Pins without a separate visual campaign machine

Pins need boards, destination links, descriptions, visual assets, and evergreen timing. bundle.social keeps Pinterest inside the same campaign workflow instead of a disconnected visual queue.

Workflow

How it works

Connect accounts once, then create and schedule posts with channel-specific fields from one API.

01

Create an API key

Generate an organization API key in the dashboard and use it with the x-api-key header.

02

Connect accounts

Connect each social account once. bundle.social keeps the account mapping ready for future posts.

03

We validate the board and media first

Pinterest pins fail when the board is missing, the destination media URL is unreachable, or a video pin lacks its required cover image. You send one request; bundle.social validates board access and media before the pin is created.

Product architecture

Build social media workflows without rebuilding every platform

Pinterest API for Pins, boards, and evergreen campaigns

Commerce platforms, creator tools, and content products integrate Pinterest for Pins, board selection, destination links, descriptions, alt text, and scheduling. Two constraints shape the integration more than the publish call itself: a Pin cannot exist without a board, and Pinterest fetches destination media that has to stay reachable.

bundle.social validates board access and media before the Pin is created and publishes through the same post endpoint as every other channel, so Pinterest becomes one more target in an existing workflow rather than a separate visual pipeline.

Boards are client-side state, and they move

Boards belong to the connected account and change without notice: renamed, archived, made secret, reorganized into sections. A stored board ID that was valid at compose time can be gone at publish time, which is why reading the user's boards in the composer beats hard-coding a target. A video Pin additionally requires its cover image.

bundle.social reads boards through the API so users pick from boards that actually exist, and reports a board problem as a board problem rather than a generic publish failure.

Evergreen content pays back scheduling discipline

Pins keep earning saves and clicks months after publishing, and Pinterest rewards many distinct Pins pointing at one destination more than the same Pin repeated. For catalog-driven products that makes automated Pin creation a legitimate volume play, provided each Pin carries its own description, alt text, and destination.

With scheduling, status tracking, and analytics where the account exposes them in the same API, Pinterest slots into catalog pipelines and campaign tooling without a separate calendar.

Capabilities

Pinterest API workflows for evergreen visual campaigns

Board-aware Pin payloads, destination links, alt text, media references, scheduling, and status tracking for long-tail content.

Board-specific Pin payloads

Create Pinterest Pins with board IDs, destination links, descriptions, alt text, and media references through the same post endpoint.

API key authentication

Use one bundle.social API key for server-to-server requests while users connect Pinterest accounts through the hosted OAuth flow.

Evergreen campaign scheduling

Schedule visual campaigns around launches, seasons, and catalog drops without building a separate Pinterest queue.

Post status and retry tracking

Track Pinterest Pins through scheduled, processing, posted, retrying, and error states from the API or dashboard.

Platform specifics

Pinterest API specifics for evergreen visual campaigns

Pinterest works best when products treat Pins as searchable visual assets, not just another short-lived social post.

Boards shape distribution

Every Pin needs the right board context. Model board selection clearly so ecommerce, creator, and campaign teams can keep content organized.

Destination links matter

Pins drive evergreen traffic through destination links, so validate URLs and product landing pages before scheduling visual campaigns.

Alt text helps accessibility and discovery

Use altText and clear descriptions so Pins are easier to understand, index, and reuse across long-running visual search journeys.

Developer example

Schedule a Pinterest post

Examples use bundle.social's public API shape: API key authentication, a post date, selected social account types, and platform-specific data.

TypeScript
API request
1await fetch("https://api.bundle.social/api/v1/post", {2  method: "POST",3  headers: {4    "x-api-key": process.env.BUNDLE_SOCIAL_API_KEY,5    "Content-Type": "application/json"6  },7  body: JSON.stringify({8    teamId: "team_123",9    title: "New arrival Pin",10    postDate: "2026-05-14T10:00:00.000Z",11    status: "SCHEDULED",12    socialAccountTypes: ["PINTEREST"],13    data: {14      PINTEREST: {15        boardId: "board_inspiration_feed",16        link: "https://example.com/products/new-arrival",17        altText: "New arrival product shot on white background",18        description: "Our latest drop - tap to shop."19      }20    }21  })22});

Supported content

PinsImagesBoard selectionDescriptionsDestination linksAlt textNotes

Honest limitations

  • Pinterest board access and account permissions still control where Pins can publish.
  • Pinterest media and link rules must be respected by the content payload.
  • Some shopping or ads features are outside a standard posting workflow.

Guarantees

Developer-first infrastructure

Visible post status

Track scheduled, processing, posted, retrying, and error states per post.

Verbose errors

When native APIs fail, we return human-readable error messages and actionable recovery steps.

Flat pricing

No per-post counting. Predictable pricing for teams managing many users, workspaces, and connected accounts.

Same-day support

Direct access to the engineers building the API. We respond to technical issues the same day, sometimes the same hour.

Resources

Technical guides & documentation

FAQ

Questions developers ask before building

What does the Pinterest API validate before a pin is created?

Board access and media reachability. A pin without a valid board cannot exist, and a destination media URL that is unreachable fails the create call. A video pin additionally requires its cover image.

Which Pinterest scopes are involved?

Scoped OAuth covering pin creation and board reads, so a user can pick from boards that actually exist rather than typing a name that fails at publish. bundle.social handles the consent round.

Can we read a user's boards before scheduling?

Yes, and it is worth doing in the composer. Board structure is client-side state that changes without notice, so resolving it at compose time rather than at publish time is what keeps scheduled pins from failing silently.

Does this replace Pinterest API?

No. bundle.social calls Pinterest API for you and absorbs the work around it: token storage and refresh, media handling, scheduling, status transitions, and turning platform errors into a cause and a next action.

Are Pinterest analytics available through the API?

Yes, for the metrics the connected account and Pinterest API actually expose. Availability depends on account type and granted permissions, so treat analytics as best-effort and delivery status as guaranteed.