Skip to main content
LinkedIn logo

​
Overview

Add LinkedIn to any ModuleX agent or workflow. Professional social networking platform for managing posts, comments, likes, profiles, organizations, and ad accounts via the LinkedIn REST API (api.linkedin.com/rest).
Categories: Social Media · Marketing · Communication · Auth: OAuth2 · Actions: 18

​
Authentication

​
OAuth2 Authentication

Connect using LinkedIn OAuth (recommended)

​
Required Credentials

FieldDescriptionRequiredFormat
Client IDLinkedIn OAuth App Client IDYes-
Client SecretLinkedIn OAuth App Client SecretYes-

​
OAuth Configuration

  • Authorization URL: https://www.linkedin.com/oauth/v2/authorization
  • Token URL: https://www.linkedin.com/oauth/v2/accessToken
  • Scopes: openid, profile, email, w_member_social

​
Available Actions

​
Parameters

​
urn_to_comment
string
required
The share or user generated content post URN where the comment will be made
​
actor
string
required
Entity authoring the comment, must be a person or organization URN (e.g. urn:li:person:ABC123)
​
message
string
required
Text of the comment
​
content
object
Optional media content entities as a JSON object
​
parent_comment
string
URN of the parent comment for nested comments (not available for first-level comments)

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "data": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Data"
    }
  },
  "required": [
    "success"
  ],
  "title": "CreateCommentOutput",
  "type": "object"
}

​
Parameters

​
organization_id
string
required
ID of the organization that will author the post
​
image_url
string
required
URL of the image to upload and post
​
text
string
required
Text to be posted on the LinkedIn timeline

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "post_urn": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Post Urn"
    }
  },
  "required": [
    "success"
  ],
  "title": "CreateImagePostOrganizationOutput",
  "type": "object"
}

​
Parameters

​
image_url
string
required
URL of the image to upload and post
​
text
string
required
Text to be posted on the LinkedIn timeline
​
visibility
string
required
Visibility restrictions on content. Valid values: CONNECTIONS, PUBLIC, LOGGED_IN

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "post_urn": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Post Urn"
    }
  },
  "required": [
    "success"
  ],
  "title": "CreateImagePostUserOutput",
  "type": "object"
}

​
Parameters

​
parent_urn
string
required
The top-level share URN or user generated content URN where the like will be performed
​
actor
string
required
Entity performing the like, must be a person or organization URN
​
object
string
required
URN of the entity to which the like belongs, should be a sub-entity of the top-level share

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    }
  },
  "required": [
    "success"
  ],
  "title": "CreateLikeOnShareOutput",
  "type": "object"
}

​
Parameters

​
organization_id
string
required
ID of the organization that will author the post
​
text
string
required
Text to be posted on the LinkedIn timeline
​
article
string
URL of an article to share with the post

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "data": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Data"
    }
  },
  "required": [
    "success"
  ],
  "title": "CreateTextPostOrganizationOutput",
  "type": "object"
}

​
Parameters

​
visibility
string
required
Visibility restrictions on content. Valid values: CONNECTIONS, PUBLIC, LOGGED_IN
​
text
string
required
Text to be posted on the LinkedIn timeline
​
article
string
URL of an article to share with the post

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "data": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Data"
    }
  },
  "required": [
    "success"
  ],
  "title": "CreateTextPostUserOutput",
  "type": "object"
}

​
Parameters

​
post_id
string
required
URN of the post to delete (e.g. urn:li:ugcPost:123 or urn:li:share:123)

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    }
  },
  "required": [
    "success"
  ],
  "title": "DeletePostOutput",
  "type": "object"
}

​
Parameters

​
ad_account_id
string
required
ID of the ad account to fetch

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "data": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Data"
    }
  },
  "required": [
    "success"
  ],
  "title": "FetchAdAccountOutput",
  "type": "object"
}

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "data": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Data"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetCurrentMemberProfileOutput",
  "type": "object"
}

​
Parameters

​
person_id
string
required
Identifier of the person to retrieve

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "data": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Data"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetMemberProfileOutput",
  "type": "object"
}

​
Parameters

​
people_ids
array
required
List of person ID strings to retrieve

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "results": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Results",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetMultipleMemberProfilesOutput",
  "type": "object"
}

​
Parameters

​
role
string
Limit results to a specific role. Valid values: ADMINISTRATOR, DIRECT_SPONSORED_CONTENT_POSTER, RECRUITING_POSTER, LEAD_CAPTURE_ADMINISTRATOR, LEAD_GEN_FORMS_MANAGER, ANALYST, CURATOR, CONTENT_ADMINISTRATOR
​
state
string
Limit results to a specific role state. Valid values: APPROVED, REJECTED, REQUESTED, REVOKED

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "data": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Data"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetOrgMemberAccessOutput",
  "type": "object"
}

​
Parameters

​
organization_id
string
required
ID of the organization for which the access control information is being retrieved
​
max
integer
Maximum number of results to return (Default: 50)

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "elements": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Elements",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetOrganizationAccessControlOutput",
  "type": "object"
}

​
Parameters

​
organization_id
string
required
ID of the organization for which administrators are being retrieved
​
max_pages
integer
Maximum number of pages to fetch (1-500) (Default: 50)

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "elements": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Elements",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetOrganizationAdministratorsOutput",
  "type": "object"
}

​
Parameters

​
include_original_image
boolean
Whether to include the original image data in the response (requires special permissions) (Default: false)

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "data": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Data"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetProfilePictureFieldsOutput",
  "type": "object"
}

​
Parameters

​
comment_urn
string
required
Parent comment URN to retrieve nested comments for. A composite URN using comment ID and activity URN
​
max
integer
Maximum number of results to return (Default: 50)

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "elements": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Elements",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "RetrieveCommentsOnCommentsOutput",
  "type": "object"
}

​
Parameters

​
entity_urn
string
required
URN of the entity to retrieve comments on
​
max
integer
Maximum number of results to return (Default: 50)

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "elements": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Elements",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "RetrieveCommentsSharesOutput",
  "type": "object"
}

​
Parameters

​
search_by
string
required
Field to search by. Valid values: vanityName, emailDomain
​
search_term
string
required
Keyword to search for
​
max
integer
Maximum number of results to return (Default: 50)

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "elements": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Elements",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "SearchOrganizationOutput",
  "type": "object"
}

​
Limits & Quotas

  • LinkedIn API rate limits vary by product and endpoint. Generally 100 requests per day for most marketing/community management endpoints per OAuth app.
  • Organization-level posting endpoints are subject to daily limits per organization.
  • The LinkedIn-Version header is hardcoded to 202509; LinkedIn periodically deprecates older API versions.
  • Non-2xx responses and timeouts are caught and returned as success=False + error rather than raising.

Hootsuite

Product Hunt

AgentMail