Postpone Logo
Scheduling Posts

Pinterest

Schedule pins to Pinterest boards

Mutation

Use the schedulePinterestPost mutation to schedule pins to Pinterest boards:

Mutation
mutation SchedulePinterestPost($input: SchedulePinterestPostInput!) {
  schedulePinterestPost(input: $input) {
    success
    errors {
      field
      message
    }
    post {
      id
      socialAccount {
        id
        username
      }
      publishingStatus
      title
      description
      link
      dominantColor
      note
      boardId
      gallery {
        id
        galleryMediaSet {
          id
          media {
            url
            mimeType
          }
        }
      }
      submissions {
        id
        postAt
      }
    }
  }
}

Input Parameters

SchedulePinterestPostInput

username
String! required
The username of the connected Pinterest account to post from
title
String! required
The title of the pin (max 100 characters)
description
String
The description of the pin (max 500 characters)
link
String
URL that the pin should link to when clicked
dominantColor
String
Hex color code representing the dominant color of the pin image
note
String
Private note for the pin (only visible to you)
boardId
String! required
The ID of the Pinterest board to pin to
gallery
GalleryInput
Media gallery containing the pin image
mediaName
String
Name of a file from your Content Library (case-insensitive)
mediaUrl
String
URL of an image to upload and use for the pin
submissions
[PinterestPostSubmissionInputType!]! required
Array of submissions defining when to post (minimum 1 submission)
publishingStatus
PublishingStatusType
Publishing status. Options: READY_TO_PUBLISH, DRAFT (default: READY_TO_PUBLISH)
postTags
[ID!]
Array of post tag IDs to organize your content
id
ID
ID of existing post when updating (only for updates)

PinterestPostSubmissionInputType

Each submission defines a specific posting schedule:

postAt
DateTime! required
When to publish the pin (must be in the future)
id
ID
ID of existing submission when updating (only for updates)

Examples

Simple Pinterest Pin

Schedule a basic Pinterest pin with an image from URL.

{
  "input": {
    "username": "mybrand",
    "title": "Delicious Chocolate Chip Cookies Recipe",
    "description": "Easy homemade chocolate chip cookies that are crispy on the outside and chewy on the inside. Perfect for any occasion! Get the full recipe on our blog.",
    "link": "https://example.com/chocolate-chip-cookies-recipe",
    "mediaUrl": "https://example.com/cookie-image.jpg",
    "boardId": "123456789",
    "submissions": [
      {
        "postAt": "2025-12-01T15:00:00Z"
      }
    ]
  }
}

Pinterest Pin with Content Library Media

Schedule a pin using an image from your Content Library.

{
  "input": {
    "username": "mybrand",
    "title": "10 Home Decor Ideas for Small Spaces",
    "description": "Transform your small space with these creative and budget-friendly home decor ideas. From storage solutions to color schemes, we've got you covered! #homedecor #smallspaces #interiordesign",
    "link": "https://example.com/small-space-decor-ideas",
    "mediaName": "small-space-decor.jpg",
    "dominantColor": "#F4E4BC",
    "boardId": "987654321",
    "submissions": [
      {
        "postAt": "2025-12-01T18:30:00Z"
      }
    ]
  }
}

Pinterest Pin with Board Section

Schedule a pin to a specific section within a board.

{
  "input": {
    "username": "mybrand",
    "title": "Summer Wedding Centerpiece Ideas",
    "description": "Beautiful and elegant centerpiece ideas perfect for summer weddings. These floral arrangements will add the perfect touch to your special day.",
    "link": "https://example.com/summer-wedding-centerpieces",
    "mediaUrl": "https://example.com/wedding-centerpiece.jpg",
    "boardId": "456789123",
    "boardSectionId": "789123456",
    "submissions": [
      {
        "postAt": "2025-12-01T12:00:00Z"
      }
    ]
  }
}

Pinterest Pin with Private Note

Schedule a pin with a private note for internal organization.

{
  "input": {
    "username": "mybrand",
    "title": "Best Travel Destinations 2024",
    "description": "Discover the most amazing travel destinations for 2024! From hidden gems to popular hotspots, plan your next adventure with our comprehensive guide.",
    "link": "https://example.com/travel-destinations-2024",
    "mediaUrl": "https://example.com/travel-destinations.jpg",
    "note": "Part of Q4 travel content campaign - scheduled for peak engagement time",
    "dominantColor": "#4A90E2",
    "boardId": "321654987",
    "submissions": [
      {
        "postAt": "2025-12-01T20:00:00Z"
      }
    ]
  }
}

Fashion Pinterest Pin

Schedule a fashion-related pin with rich description and keywords.

{
  "input": {
    "username": "fashionbrand",
    "title": "Cozy Fall Outfit Ideas for 2024",
    "description": "Stay stylish and comfortable this fall with these cozy outfit ideas! Perfect combinations of sweaters, boots, and accessories for the season. #falloutfits #fashion2024 #cozystyle #autumn #ootd",
    "link": "https://example.com/fall-fashion-2024",
    "mediaName": "fall-outfit-collage.jpg",
    "dominantColor": "#D2691E",
    "boardId": "159753468",
    "submissions": [
      {
        "postAt": "2025-12-01T16:45:00Z"
      }
    ]
  }
}

Response Types

Success Response

{
  "data": {
    "schedulePinterestPost": {
      "success": true,
      "errors": [],
      "post": {
        "id": "123",
        "socialAccount": {
          "id": "456",
          "username": "mybrand"
        },
        "publishingStatus": "READY_TO_PUBLISH",
        "title": "Delicious Chocolate Chip Cookies Recipe",
        "description": "Easy homemade chocolate chip cookies that are crispy on the outside and chewy on the inside. Perfect for any occasion! Get the full recipe on our blog.",
        "link": "https://example.com/chocolate-chip-cookies-recipe",
        "dominantColor": null,
        "note": null,
        "boardId": "123456789",
        "boardSectionId": null,
        "gallery": {
          "id": "789",
          "media": [
            {
              "id": "101",
              "url": "https://cdn.example.com/cookie-image.jpg",
              "type": "image"
            }
          ]
        },
        "submissions": [
          {
            "id": "112",
            "postAt": "2025-12-01T15:00:00Z"
          }
        ]
      }
    }
  }
}

Error Response

{
  "data": {
    "schedulePinterestPost": {
      "success": false,
      "errors": [
        {
          "field": "title",
          "message": "Pinterest pin titles cannot exceed 100 characters."
        }
      ],
      "post": null
    }
  }
}

Validation Rules

The API enforces Pinterest's content policies and technical requirements:
  • Title Length: Maximum 100 characters
  • Description Length: Maximum 500 characters
  • Image Requirements: JPEG, PNG, or GIF format
  • Image Size: Minimum 600x900 pixels, maximum 1000x1500 pixels recommended
  • Aspect Ratio: 2:3 aspect ratio performs best (e.g., 1000x1500)
  • File Size: Maximum 20MB per image
  • Link Requirements: Must be a valid, accessible URL
  • Board Access: Must have write access to the specified board
  • Content Quality: Images should be high-quality and relevant to the title/description
  • Scheduling: Posts must be scheduled for future dates only
  • Account Limits: Respects your plan's monthly pin limits

Common Errors

LinkedIn

Schedule professional posts to LinkedIn profiles and pages

Mastodon

Schedule posts and threads to Mastodon and other ActivityPub servers