CreatePost operation

Author: KirillSergeevich

examples/post-actions.ts

@@ -8,6 +8,9 @@ async function postActionsExample(): Promise<void> {
 
   try {
     console.log('🚀 Linked API Post Actions example starting...');
+    await createPost(linkedapi);
+    await createPostWithAttachments(linkedapi);
+    await createCompanyPost(linkedapi);
     await reactToPost(linkedapi);
     await commentOnPost(linkedapi);
   } catch (error) {
@@ -20,6 +23,69 @@ async function postActionsExample(): Promise<void> {
   }
 }
 
+async function createPost(linkedapi: LinkedApi): Promise<void> {
+  console.log('\n📝 Creating a simple text post...');
+
+  const workflowId = await linkedapi.createPost.execute({
+    text: 'Excited to share our latest product updates!\n\n#innovation #technology',
+  });
+  console.log('📝 Create post workflow started:', workflowId);
+
+  const result = await linkedapi.createPost.result(workflowId);
+  if (result.errors.length > 0) {
+    console.error('🚨 Errors:', JSON.stringify(result.errors, null, 2));
+  } else {
+    console.log('✅ Post created successfully');
+    console.log('🔗 Post URL:', result.data?.postUrl);
+  }
+}
+
+async function createPostWithAttachments(linkedapi: LinkedApi): Promise<void> {
+  console.log('\n🖼️ Creating a post with image attachments...');
+
+  const workflowId = await linkedapi.createPost.execute({
+    text: 'Check out these amazing photos from our team event!',
+    attachments: [
+      { url: 'https://example.com/photo1.jpg', type: 'image' },
+      { url: 'https://example.com/photo2.jpg', type: 'image' },
+    ],
+  });
+  console.log('🖼️ Create post with images workflow started:', workflowId);
+
+  const result = await linkedapi.createPost.result(workflowId);
+  if (result.errors.length > 0) {
+    console.error('🚨 Errors:', JSON.stringify(result.errors, null, 2));
+  } else {
+    console.log('✅ Post with images created successfully');
+    console.log('🔗 Post URL:', result.data?.postUrl);
+  }
+}
+
+async function createCompanyPost(linkedapi: LinkedApi): Promise<void> {
+  console.log('\n🏢 Creating a company page post with document...');
+
+  const workflowId = await linkedapi.createPost.execute({
+    text: 'Download our latest whitepaper on AI trends in 2026',
+    companyUrl: 'https://www.linkedin.com/company/acme-corp',
+    attachments: [
+      {
+        url: 'https://example.com/whitepaper.pdf',
+        type: 'document',
+        name: 'AI Trends 2026 Whitepaper',
+      },
+    ],
+  });
+  console.log('🏢 Create company post workflow started:', workflowId);
+
+  const result = await linkedapi.createPost.result(workflowId);
+  if (result.errors.length > 0) {
+    console.error('🚨 Errors:', JSON.stringify(result.errors, null, 2));
+  } else {
+    console.log('✅ Company post created successfully');
+    console.log('🔗 Post URL:', result.data?.postUrl);
+  }
+}
+
 async function reactToPost(linkedapi: LinkedApi): Promise<void> {
   console.log('\n👍 Reacting to post...');
 

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "linkedapi-node",
-  "version": "1.2.9",
+  "version": "1.2.10",
   "description": "Control your LinkedIn accounts and retrieve real-time data, all through this Node.js SDK.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package.json

@@ -29,6 +29,7 @@ export const OPERATION_NAME = {
   fetchPost: 'fetchPost',
   reactToPost: 'reactToPost',
   commentOnPost: 'commentOnPost',
+  createPost: 'createPost',
   retrieveSSI: 'retrieveSSI',
   retrievePerformance: 'retrievePerformance',
   nvSendMessage: 'nvSendMessage',

src/core/operation.ts

@@ -4,6 +4,7 @@ import type { TMappedResponse } from './mappers/base-mapper.abstract';
 import {
   CheckConnectionStatus,
   CommentOnPost,
+  CreatePost,
   CustomWorkflow,
   FetchCompany,
   FetchPerson,
@@ -101,6 +102,7 @@ class LinkedApi {
     this.fetchPost = new FetchPost(this.httpClient);
     this.reactToPost = new ReactToPost(this.httpClient);
     this.commentOnPost = new CommentOnPost(this.httpClient);
+    this.createPost = new CreatePost(this.httpClient);
     this.retrieveSSI = new RetrieveSSI(this.httpClient);
     this.retrievePerformance = new RetrievePerformance(this.httpClient);
     this.nvSendMessage = new NvSendMessage(this.httpClient);
@@ -127,6 +129,7 @@ class LinkedApi {
       this.fetchPost,
       this.reactToPost,
       this.commentOnPost,
+      this.createPost,
       this.retrieveSSI,
       this.retrievePerformance,
       this.nvSendMessage,
@@ -912,6 +915,63 @@ class LinkedApi {
    */
   public commentOnPost: CommentOnPost;
 
+  /**
+   * Create a LinkedIn post on your personal profile or a company page.
+   *
+   * This method creates a new post on LinkedIn. Posts can include text (up to 3,000 characters)
+   * and optional media attachments (images, videos, or documents). For company posts, you must
+   * have admin access to the company page.
+   *
+   * @param params - Parameters including post text, optional attachments, and optional company URL
+   * @returns Promise resolving to an object containing the created post URL
+   *
+   * @see {@link https://linkedapi.io/docs/action-st-create-post/ st.createPost Action Documentation}
+   *
+   * @example
+   * ```typescript
+   * // Create a simple text post
+   * const workflowId = await linkedapi.createPost.execute({
+   *   text: "Excited to share our latest product updates!\n\n#innovation"
+   * });
+   *
+   * const result = await linkedapi.createPost.result(workflowId);
+   * if (result.data) {
+   *   console.log("Post created:", result.data.postUrl);
+   * }
+   * ```
+   *
+   * @example
+   * ```typescript
+   * // Create a post with image attachments
+   * const workflowId = await linkedapi.createPost.execute({
+   *   text: "Check out these amazing photos from our team event!",
+   *   attachments: [
+   *     { url: "https://example.com/photo1.jpg", type: "image" },
+   *     { url: "https://example.com/photo2.jpg", type: "image" }
+   *   ]
+   * });
+   *
+   * const result = await linkedapi.createPost.result(workflowId);
+   * console.log("Post with images created:", result.data?.postUrl);
+   * ```
+   *
+   * @example
+   * ```typescript
+   * // Create a company page post with a document
+   * const workflowId = await linkedapi.createPost.execute({
+   *   text: "Download our latest whitepaper on AI trends",
+   *   companyUrl: "https://www.linkedin.com/company/acme-corp",
+   *   attachments: [
+   *     { url: "https://example.com/whitepaper.pdf", type: "document", name: "AI Trends 2025" }
+   *   ]
+   * });
+   *
+   * const result = await linkedapi.createPost.result(workflowId);
+   * console.log("Company post created:", result.data?.postUrl);
+   * ```
+   */
+  public createPost: CreatePost;
+
   /**
    * Retrieve your LinkedIn Social Selling Index (SSI) score.
    *

src/index.ts

@@ -0,0 +1,13 @@
+import { Operation, TOperationName } from '../core';
+import { SimpleWorkflowMapper } from '../mappers';
+import { TCreatePostParams, TCreatePostResult } from '../types';
+
+export class CreatePost extends Operation<TCreatePostParams, TCreatePostResult> {
+  public override readonly operationName: TOperationName = 'createPost';
+  protected override readonly mapper = new SimpleWorkflowMapper<
+    TCreatePostParams,
+    TCreatePostResult
+  >({
+    actionType: 'st.createPost',
+  });
+}

src/operations/create-post.ts

@@ -20,5 +20,6 @@ export * from './retrieve-connections';
 export * from './remove-connection';
 export * from './react-to-post';
 export * from './comment-on-post';
+export * from './create-post';
 export * from './retrieve-ssi';
 export * from './retrieve-performance';

src/operations/index.ts

@@ -123,3 +123,26 @@ export type TFetchPostParams<T extends TBaseFetchPostParams = TBaseFetchPostPara
 };
 
 export type TFetchPostResult = TPost;
+
+export const ATTACHMENT_TYPE = {
+  image: 'image',
+  video: 'video',
+  document: 'document',
+} as const;
+export type TAttachmentType = (typeof ATTACHMENT_TYPE)[keyof typeof ATTACHMENT_TYPE];
+
+export interface TCreatePostAttachment {
+  url: string;
+  type: TAttachmentType;
+  name?: string;
+}
+
+export interface TCreatePostParams extends TBaseActionParams {
+  text: string;
+  attachments?: ReadonlyArray<TCreatePostAttachment>;
+  companyUrl?: string;
+}
+
+export interface TCreatePostResult {
+  postUrl: string;
+}