Connecting and Publishing to Pinterest

Updated September 12, 2026

To publish a Pin, select a board, enter a title, and attach one image or video. For a video Pin, also attach a custom cover image.

The Maeve composer with Pinterest selected, showing the Pin title and description fields and a live Pin preview on the right — Pinterest takes a title of its own on top of the description, and the preview shows the Pin as it will appear on a board.

Connecting an Account

1
Open Settings, then Social channels
Select Pinterest from the connection grid.
2
Sign in on Pinterest
Sign in on Pinterest's sign-in page. Maeve does not receive or store your password.
3
Review the permissions
Pinterest lists the access Maeve needs for your boards, Pins and account. Choose Give access to continue. Maeve needs to read your boards as well as write Pins, because a Pin cannot be published without a board to put it on.
4
Confirm the Connected Account
Check the connected account. Its boards load when you select Pinterest in the composer.

What Maeve Asks Permission For

Permission	What stops working without it
Write Pins	Maeve cannot publish posts
Read Pins	Analytics and published history stay empty
Read boards	The board selector is unavailable
Write boards	You cannot create a new board from Maeve
Read account	Maeve cannot read the account name or picture

What Every Pin Needs

Select Pinterest in the composer, then complete the required fields:

What Pinterest gives you in the composer, and what it asks for. Every limit here is the one Maeve checks against, not the one the network advertises.

A board. Pick one from the list, or create a new one from the composer
A title. Up to 100 characters, and it cannot be left blank
One image or video. Create separate Pins for additional media
A cover image, if the Pin is a video. Pinterest does not generate one

Add a description, destination link, and alt text if needed. These fields are optional.

Boards

Select Pinterest in the composer to load the board list, then choose a board. To create one, select New Board. Turn on Keep this board secret if you do not want the board to be public.

The board selector currently loads one page of results from Pinterest. If an existing board is missing, check it on Pinterest. You can create a new board from Maeve if that suits the post.

Each Pin goes to one board. To use the same image on several boards, create a separate Pin for each board.

Keep titles within 100 characters and descriptions within 500. Longer values are trimmed when published.

The Limits

What	Limit
Title	100 characters, required
Description	500 characters
Media per Pin	Exactly 1
Image size	32MB
Image formats	JPEG, PNG and WebP
Video size	2GB
Video length	4 seconds to 15 minutes
Video formats	MP4, MOV and M4V
Video aspect ratio	Between 0.5 and 1.91

The shapes Pinterest's cropper offers, under Pinterest's own names for them. Cropping for one network leaves the file untouched everywhere else.

What Will Stop a Pin

No board chosen. Pinterest has nowhere to put the Pin
No title. Pinterest requires one on every Pin
No media, or more than one item. Exactly one image or video
A video with no cover image

Check file size, duration, and aspect ratio before scheduling. The composer does not enforce all Pinterest file limits. Files outside the limits above can fail when Pinterest processes them.

What Pinterest sends back, word for word. These are the strings Maeve shows you, so searching this page for the one on your screen should find it.

When the Connection Breaks

If an account shows Needs reconnecting, restore its connection before the next scheduled post is due.

Open Settings, then Social channels.
Find the affected account and select Reconnect.
Sign in to the same account and approve the requested permissions.

Reconnecting keeps scheduled posts attached to the account. After reconnecting, retry any posts that failed while the connection was unavailable.

Select Reconnect beside the affected account and complete the platform authorization steps.

Errors Pinterest Returns

Error message	What to do
Choose a Pinterest board before publishing	No board is set on the Pin. Pick one, or create one from the composer
Add a Pinterest title before saving or publishing	The title is blank. Pinterest requires one on every Pin
Pinterest videos require a custom cover image	A video Pin has no cover. Attach an image, since Pinterest will not take a frame from the video
Pinterest requires at least one media item before publishing	Attach one image or video
Pinterest cannot publish to the selected board	The board belongs to a different Pinterest environment than the connection. Reconnect the account, then reschedule
Pinterest currently supports only one media item per pin	More than one file is selected. A Pin takes exactly one
This account's connection has expired	Reconnect the channel in Settings, Social channels, then retry the Pin

Questions

What does a Pinterest Pin need before it will publish?

Select a board, enter a title of up to 100 characters, and attach one image or video. Video Pins also require a custom cover image.

Why does my Pinterest video need a cover image?

Maeve requires a separate cover image for video Pins. Attach it before scheduling.

Can I put more than one image on a Pin?

No. Create a separate Pin for each image.

Can I pin the same image to several boards?

Yes. Create a separate Pin for each board and reuse the image.

Can I create a Pinterest board from Maeve?

Yes. Select New Board in the composer. Turn on Keep this board secret if needed.

Why was my Pinterest video rejected for its shape?

Use a video aspect ratio between 0.5 and 1.91. Crop or resize the video, then reattach it before retrying.

Does a Pin need a description?

No. Description, destination link, and alt text are optional. The board, title, and media are required, plus a custom cover for video Pins.