Skip to content

Codex + Wahlu

Post to Pinterest from Codex with Wahlu

Connect Codex to Wahlu once, then plan, draft and schedule posts for Pinterest business accounts, posting to the board you pick for each Pin from the Codex CLI, IDE extension and app. Every schedule can wait for your approval.

Connect CodexAll Codex options
What Codex can prepare on Pinterest

  • Image Pin

    One PNG or JPEG image, up to 20 MB. 2:3 suits the feed.

  • Carousel

    2 to 5 images, square or 2:3.

  • Video Pin

    One MP4, MOV or M4V video, 4 seconds to 15 minutes, up to 1 GB.

Ask Codex for Pinterest posts

Example prompts and the steps to expect. These are illustrations, not recorded conversations.

Example prompt

“Read the changes in this branch and create a Pin for the release with a title and a link to the docs. Ask me which board, then hold it for review tomorrow at 9am.”

Example prompt

“Create a carousel Pin from the screenshots in docs/launch for the changes in this branch, with alt text for each, then run a readiness check.”

Example prompt

“List my Pinterest boards and check what's already scheduled there this week before you draft a Pin about the changes in this branch.”

What Wahlu does on Pinterest

Codex works through Wahlu's tools, so it can set the Pinterest options Wahlu supports.

Pinterest settings on a draft

Board
Required. Your agent lists the account's boards and asks which one to use.
Section
An optional section of the board.
Title and link
A title up to 100 characters and the page the Pin opens.
Alt text
A description of the image for screen readers.

Pinterest asks that you choose each Pin yourself, so confirm each Pin; looping queues, Autopilot and flows don't post to Pinterest. Only business accounts can connect.

The tool calls, in order

  1. 01

    list_targetsFinds the brand's connected Pinterest account and checks it's ready.

  2. 02

    upload_media, import_media_from_url or list_mediaBrings in the image or video, or picks one from your media library.

  3. 03

    create_draftCreates the draft with its caption and pinterest_settings, such as the post type.

  4. 04

    preflight_draftChecks the draft against Pinterest's rules without changing it.

  5. 05

    create_schedulePuts it on the calendar at pending_review, held for your approval.

Pinterest limits to know

Wahlu checks these before a post is scheduled, so the agent finds out early.

Getting images and video to Pinterest

The agent can read a file in your project and upload it with upload_media. Files over 8 MB, including most video, go to a short-lived upload link the agent sends the file to. Public links and your media library work too.

Connect Codex to Wahlu

Set this up once and Codex can work on every network you've connected, not just Pinterest.

  1. 1

    Run codex mcp add to add Wahlu. It's saved in ~/.codex/config.toml, which the Codex CLI, IDE extension and app share.

  2. 2

    Run codex mcp login wahlu and sign in to Wahlu in the browser that opens.

  3. 3

    Start a new Codex session so it picks up Wahlu's tools.

Checked against the Codex docs on 27 September 2026. Menus can change; if a step doesn't match what you see, follow the vendor's current instructions.

Add Wahlu to Codex
codex mcp add wahlu --url https://mcp.wahlu.com/mcp
codex mcp login wahlu

In the Codex IDE extension or app you can add it from the gear menu instead: MCP servers → Add server, choose Streamable HTTP and paste the URL, then restart. Codex signs in with a Client ID Metadata Document, which is what Wahlu uses.

You stay in control.

Every Wahlu plan includes agent access, through MCP and the API. You choose the workspace, brands and permissions each connection gets, and can disconnect it at any time.

Held until you approve

Agents create schedules at pending_review unless you've told them to publish. A held schedule can't publish until you approve it in Wahlu or ask an agent with Publishing permission to approve it.

Publishing is its own permission

Publishing is separate from Manage your schedule. Leave it unticked and nothing your agent schedules can go out on its own.

Checked before it's scheduled

preflight_draft reports anything that would stop a post, such as media the network won't accept or a caption that's too long, without changing anything.

Some things stay in the app

Use the app for queues, draft media and platform settings, and connecting social accounts. Agents can change the name or caption of an unused draft and approve held schedules with the right permissions.

Keep going

Your next Pinterest post, drafted by Codex.

Connect your Pinterest account in Wahlu, then give Codex a specific brief.

Open WahluAll Codex options