Postpone Logo
Scheduling Posts

LinkedIn

Schedule professional posts to LinkedIn profiles and pages

Mutation

Use the scheduleLinkedInPost mutation to schedule professional content to LinkedIn:

Mutation
mutation ScheduleLinkedInPost($input: ScheduleLinkedInPostInput!) {
  scheduleLinkedInPost(input: $input) {
    success
    errors {
      field
      message
    }
    post {
      id
      socialAccount {
        id
        username
      }
      publishingStatus
      text
      link
      visibility
      firstComment
      gallery {
        id
        galleryMediaSet {
          id
          media {
            url
            mimeType
          }
        }
      }
      submissions {
        id
        postAt
      }
    }
  }
}

Input Parameters

ScheduleLinkedInPostInput

username
String! required
The username of the connected LinkedIn account to post from
text
String! required
The main text content of the post (max 3,000 characters)
link
String
URL to share in the post (optional)
visibility
VisibilityType! required
Post visibility setting. Options: PUBLIC, CONNECTIONS, LOGGED_IN
firstComment
String
The first comment to be posted automatically with the post
gallery
GalleryInput
Media gallery containing images or videos
mediaName
String
Name of a file from your Content Library (case-insensitive)
mediaUrl
String
URL of media to upload and attach to the post
submissions
[LinkedInPostSubmissionInputType!]! 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)

LinkedInPostSubmissionInputType

Each submission defines a specific posting schedule:

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

Examples

Simple LinkedIn Post

Schedule a basic LinkedIn post with text content.

{
  "input": {
    "username": "myprofile",
    "text": "Excited to share insights from our latest project! The key to success in digital transformation is focusing on people-first strategies that empower teams to embrace change.\n\n#DigitalTransformation #Leadership #Innovation",
    "visibility": "PUBLIC",
    "submissions": [
      {
        "postAt": "2025-12-01T09:00:00Z"
      }
    ]
  }
}

LinkedIn Post with Media

Schedule a LinkedIn post with an image from URL.

{
  "input": {
    "username": "myprofile",
    "text": "Just wrapped up an incredible conference! Here are my key takeaways from the sessions on emerging technologies and their impact on business strategy.\n\n📊 Data-driven decision making is more crucial than ever\n🚀 AI adoption requires thoughtful change management\n🤝 Collaboration tools are reshaping remote work\n\nWhat trends are you seeing in your industry?\n\n#Conference2024 #Technology #BusinessStrategy",
    "mediaUrl": "https://example.com/conference-photo.jpg",
    "visibility": "PUBLIC",
    "submissions": [
      {
        "postAt": "2025-12-01T14:30:00Z"
      }
    ]
  }
}

LinkedIn Post with Link Share

Schedule a LinkedIn post sharing an article or resource.

{
  "input": {
    "username": "myprofile",
    "text": "Great article on the future of remote work! The insights about hybrid collaboration models really resonated with our team's experience.\n\nKey highlights:\n• Flexible work arrangements increase productivity by 25%\n• Virtual team building requires intentional effort\n• Technology should enable, not complicate workflows\n\nWhat's your take on the future of work? Share your thoughts below! 👇\n\n#RemoteWork #FutureOfWork #Productivity #TeamCollaboration",
    "link": "https://example.com/remote-work-article",
    "visibility": "PUBLIC",
    "submissions": [
      {
        "postAt": "2025-12-01T11:15:00Z"
      }
    ]
  }
}

LinkedIn Post with First Comment

Schedule a LinkedIn post with an automatic first comment.

{
  "input": {
    "username": "myprofile",
    "text": "Thrilled to announce that our team has successfully completed the Q4 project ahead of schedule! 🎉\n\nThis achievement wouldn't have been possible without the dedication and innovative thinking of every team member.\n\n#TeamWork #ProjectSuccess #Innovation #Milestone",
    "firstComment": "Special thanks to @colleague1 @colleague2 and @colleague3 for their outstanding contributions to this project. Your expertise made all the difference!",
    "mediaName": "team-celebration.jpg",
    "visibility": "PUBLIC",
    "submissions": [
      {
        "postAt": "2025-12-01T16:00:00Z"
      }
    ]
  }
}

Connections-Only Post

Schedule a post visible only to your LinkedIn connections.

{
  "input": {
    "username": "myprofile",
    "text": "Personal update for my network: After 5 amazing years at TechCorp, I'm excited to start a new chapter as Senior Director at InnovateCo!\n\nLooking forward to bringing my passion for digital transformation to help drive growth in the fintech space.\n\nGrateful for all the connections and opportunities that have led me here. Let's stay in touch!\n\n#CareerUpdate #NewBeginnings #Grateful #FinTech",
    "visibility": "CONNECTIONS",
    "submissions": [
      {
        "postAt": "2025-12-01T08:00:00Z"
      }
    ]
  }
}

Response Types

Success Response

{
  "data": {
    "scheduleLinkedInPost": {
      "success": true,
      "errors": [],
      "post": {
        "id": "123",
        "socialAccount": {
          "id": "456",
          "username": "myprofile"
        },
        "publishingStatus": "READY_TO_PUBLISH",
        "text": "Excited to share insights from our latest project! The key to success in digital transformation is focusing on people-first strategies that empower teams to embrace change.\n\n#DigitalTransformation #Leadership #Innovation",
        "link": null,
        "visibility": "PUBLIC",
        "firstComment": null,
        "gallery": null,
        "submissions": [
          {
            "id": "789",
            "postAt": "2025-12-01T09:00:00Z"
          }
        ]
      }
    }
  }
}

Error Response

{
  "data": {
    "scheduleLinkedInPost": {
      "success": false,
      "errors": [
        {
          "field": "text",
          "message": "LinkedIn posts cannot exceed 3,000 characters."
        }
      ],
      "post": null
    }
  }
}

Validation Rules

The API enforces LinkedIn's content policies and professional standards:
  • Text Length: Maximum 3,000 characters per post
  • Media: Supports images (JPEG, PNG, GIF) and videos (MP4, MOV, WMV)
  • Image Requirements: Maximum 20MB, minimum 552x552 pixels
  • Video Requirements: Maximum 5GB, minimum 256x144 pixels, maximum 10 minutes
  • Link Previews: Automatically generated for valid URLs
  • Professional Tone: Content should maintain professional standards
  • Hashtags: Use relevant professional hashtags for better discoverability
  • Mentions: Can mention other LinkedIn users with @ symbol
  • Scheduling: Posts must be scheduled for future dates only
  • Account Limits: Respects your plan's monthly post limits

Common Errors

YouTube Shorts

Schedule short-form video content to YouTube

Pinterest

Schedule pins to Pinterest boards