# Linkedin

Your Toolhouse AI Worker can connect to Linkedin using 22 specialized tools.

## Auth Connection

This service requires an auth connection to use its tools. You can set this up in your Toolhouse dashboard under [Auth Connections](https://toolhouse.app/auth-connections?authkit_slugs=linkedin).

## Tools (22)

### `Linkedin Create Article Or Url Share`

Integration name: **LINKEDIN\_CREATE\_ARTICLE\_OR\_URL\_SHARE**

Tool to create an article or URL share on LinkedIn using the UGC Posts API. Use when you need to share a link with optional commentary on LinkedIn. Supports sharing URLs as articles with customizable visibility settings.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                      | Description                                                                                                                                                                      |
| ----------------- | ------ | :------: | ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `author`          | string |     ✅    | `"urn:li:person:F6kGF1Uduq"` | URN of the author (person or organization). For a person: 'urn:li:person:{id}'. For an organization: 'urn:li:organization:{id}'. Use GET\_MY\_INFO action to get your person ID. |
| `visibility`      | object |     ✅    | —                            | Visibility settings for the post. Controls who can see the shared content.                                                                                                       |
| `lifecycleState`  | string |          | —                            | State of the post. Use 'PUBLISHED' to post immediately or 'DRAFT' to save as draft.                                                                                              |
| `specificContent` | object |     ✅    | —                            | Container for the share content including URL, commentary, and media category.                                                                                                   |

***

### `Linkedin Create Comment On Post`

Integration name: **LINKEDIN\_CREATE\_COMMENT\_ON\_POST**

Tool to create a first-level or nested comment on a LinkedIn share, UGC post, or parent comment via the Social Actions Comments API. Use when you need to engage with posts by adding comments or replying to existing comments. Supports text comments with optional @-mentions and image attachments.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type   | Required | Example                                                                   | Description                                                                                                                                                                                                                                                                      |
| --------------- | ------ | :------: | ------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `actor`         | string |     ✅    | `"urn:li:person:abcd1234"`                                                | Entity which authored the comment. For personal comments: 'urn:li:person:{id}'. For organization comments: 'urn:li:organization:{id}'. Use the GET\_USER\_INFO action to retrieve the 'id' field.                                                                                |
| `object`        | string |     ✅    | `"urn:li:share:7123456789012345678"`                                      | The URN of the share or ugcPost that contains the comment. Typically the same as target\_urn for first-level comments, or the root post URN for nested comments. Must be 'urn:li:share:{id}' or 'urn:li:ugcPost:{id}'. Activity URNs ('urn:li:activity:{id}') are NOT supported. |
| `content`       | array  |          | —                                                                         | Array of content entities such as images to include in the comment. Each entity should contain an image URN or other content type.                                                                                                                                               |
| `message`       | object |     ✅    | —                                                                         | The comment message content including text and optional @-mentions.                                                                                                                                                                                                              |
| `target_urn`    | string |     ✅    | `"urn:li:share:7123456789012345678"`                                      | The URN of the share, UGC post, or parent comment where the comment will be created. Must be 'urn:li:share:{id}', 'urn:li:ugcPost:{id}', or 'urn:li:comment:({parentUrn},{commentId})'. Activity URNs ('urn:li:activity:{id}') are NOT supported.                                |
| `parentComment` | string |          | `"urn:li:comment:(urn:li:share:7123456789012345678,7198765432109876543)"` | For nested comments (replies), the URN of the parent comment being replied to. Format: 'urn:li:comment:({parentUrn},{commentId})'. Leave empty for first-level comments on the post.                                                                                             |

***

### `Linkedin Create Linked In Post`

Integration name: **LINKEDIN\_CREATE\_LINKED\_IN\_POST**

Creates a new post on LinkedIn for the authenticated user or an organization they manage. Requires w\_member\_social scope for posting as a person, and w\_organization\_social scope for posting as an organization (with ADMINISTRATOR, DIRECT\_SPONSORED\_CONTENT\_POSTER, or CONTENT\_ADMIN role).

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                   | Type    | Required | Example                                      | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| --------------------------- | ------- | :------: | -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `author`                    | string  |     ✅    | `"urn:li:person:F6kGF1Uduq"`                 | The URN of the LinkedIn member or organization creating the post. IMPORTANT: Replace placeholder text with actual ID values. For a person: use 'urn:li:person:\<actual\_person\_id>' (e.g., 'urn:li:person:F6kGF1Uduq' or 'urn:li:person:123456789'). Requires w\_member\_social scope. For an organization: use 'urn:li:organization:\<actual\_org\_id>' (e.g., 'urn:li:organization:987654321'). Requires w\_organization\_social scope and you must have ADMINISTRATOR, DIRECT\_SPONSORED\_CONTENT\_POSTER, or CONTENT\_ADMIN role for the organization. Get your person ID using the GET\_MY\_INFO action, or get organization IDs from GET\_COMPANY\_INFO. Do NOT pass literal placeholder text like '{id}' or '{organization\_id}'. |
| `images`                    | array   |          | —                                            | Array of images to upload and attach to the post. Each element is a Supports 1-20 images. For a single image, use a list with one element. LinkedIn will automatically use the appropriate content type (media for single image, multiImage for 2+ images).                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `container`                 | string  |          | —                                            | Container entity URN for posting within a specific container (e.g., 'urn:li:group:123456' for group posts). Use this field when posting to a group or other container entity.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `commentary`                | string  |     ✅    | `"Excited to share our new product update!"` | The main text content of the post. This field supports plain text and @-mentions (e.g., @[LinkedIn Member](urn:li:person:xxxx)). Maximum length: 3000 characters.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `visibility`                | string  |          | —                                            | Controls who can see the post. 'PUBLIC' makes it visible to everyone, 'CONNECTIONS' to connections only, 'LOGGED\_IN' to signed-in LinkedIn members, and 'CONTAINER' for specific group/event posts.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `distribution`              | object  |          | —                                            | Specifies distribution rules for the post, including feed distribution and targeting.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `lifecycleState`            | string  |          | `"PUBLISHED"`                                | The state of the post. Use 'PUBLISHED' to post directly, 'DRAFT' to save as a draft, or 'PUBLISH\_REQUESTED' if the post requires review before publishing.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `reshareContext`            | object  |          | —                                            | Context for resharing another post.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `contentLandingPage`        | string  |          | —                                            | URL of the landing page that opens when the call-to-action button is clicked. Required when contentCallToActionLabel is specified.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `contentCallToActionLabel`  | string  |          | —                                            | Call-to-action button labels for posts.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `isReshareDisabledByAuthor` | boolean |          | —                                            | Set to true to prevent others from resharing this post.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |

***

### `Linkedin Delete Linked In Post`

Integration name: **LINKEDIN\_DELETE\_LINKED\_IN\_POST**

Deletes a specific LinkedIn post (share) by its unique `share_id`, which must correspond to an existing share.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter  | Type   | Required | Example                 | Description                                                                                                                                                                     |
| ---------- | ------ | :------: | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `share_id` | string |     ✅    | `"7245341016004718592"` | Unique identifier of the LinkedIn share (post) to be deleted. Accepts either numeric ID (e.g., '7245341016004718592') or URN format (e.g., 'urn:li:share:7245341016004718592'). |

***

### `Linkedin Delete Post`

Integration name: **LINKEDIN\_DELETE\_POST**

Delete a LinkedIn post using the Posts API REST endpoint. Supports both ugcPost and share URN formats. The endpoint is idempotent - previously deleted posts return success (204).

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter  | Type   | Required | Example                       | Description                                                                                                                                                                                      |
| ---------- | ------ | :------: | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `post_urn` | string |     ✅    | `"urn:li:ugcPost:7890123456"` | The URN of the post to delete. Accepts either ugcPost or share URN formats (e.g., 'urn:li:ugcPost:7890123456' or 'urn:li:share:7245341016004718592'). The URN will be URL-encoded automatically. |

***

### `Linkedin Delete Ugc Post`

Integration name: **LINKEDIN\_DELETE\_UGC\_POST**

Delete a UGC post using the legacy UGC Post API endpoint. Use when you need to delete a post using the v2/ugcPosts endpoint. Deletion is idempotent - previously deleted posts also return success.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter      | Type   | Required | Example                       | Description                                                                                                                                        |
| -------------- | ------ | :------: | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ugc_post_urn` | string |     ✅    | `"urn:li:ugcPost:7890123456"` | The URN of the UGC post or share to delete. Format: 'urn:li:ugcPost:{id}' or 'urn:li:share:{id}'. Will be URL-encoded automatically by the action. |

***

### `Linkedin Get Ad Targeting Facets`

Integration name: **LINKEDIN\_GET\_AD\_TARGETING\_FACETS**

Tool to retrieve available ad targeting facets from LinkedIn Marketing API. Use when you need to discover what targeting options are available for ad campaigns (e.g., locations, industries, job functions).

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

*No parameters required.*

***

### `Linkedin Get Audience Counts`

Integration name: **LINKEDIN\_GET\_AUDIENCE\_COUNTS**

Retrieves audience size counts for specified targeting criteria. Use when estimating reach for LinkedIn ad campaigns or targeted content.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type   | Required | Example                                                                                                   | Description                                                                                                                                                                                                                                                                                                                                                                                                         |
| ------------------- | ------ | :------: | --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `q`                 | string |          | `"targetingCriteriaV2"`                                                                                   | Query type parameter. Must be 'targetingCriteriaV2' for targeting criteria queries.                                                                                                                                                                                                                                                                                                                                 |
| `targetingCriteria` | string |     ✅    | `"(include:(and:List((or:(urn%3Ali%3AadTargetingFacet%3Alocations:List(urn%3Ali%3Ageo%3A102221843))))))"` | Targeting criteria with URL-encoded URNs. Format: (include:(and:List((or:(urn%3Ali%3AadTargetingFacet%3AFACET:List(urn%3Ali%3ATYPE%3AID)))))). IMPORTANT: Only the URN colons should be encoded as %3A, keep the structure syntax (parentheses, colons in 'and:' and 'or:') unencoded. Example for locations: (include:(and:List((or:(urn%3Ali%3AadTargetingFacet%3Alocations:List(urn%3Ali%3Ageo%3A102221843)))))) |

***

### `Linkedin Get Company Info`

Integration name: **LINKEDIN\_GET\_COMPANY\_INFO**

Retrieves organizations where the authenticated user has specific roles (ACLs), to determine their management or content posting capabilities for LinkedIn company pages.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example           | Description                                                                         |
| --------- | ------- | :------: | ----------------- | ----------------------------------------------------------------------------------- |
| `role`    | string  |          | `"ADMINISTRATOR"` | The specific role to filter organization ACLs by.                                   |
| `count`   | integer |          | `"10"`            | The number of organization ACLs to return per page.                                 |
| `start`   | integer |          | `"0"`             | The starting index for pagination, representing the number of initial ACLs to skip. |
| `state`   | string  |          | `"APPROVED"`      | The approval state of the role to filter by.                                        |

***

### `Linkedin Get Image`

Integration name: **LINKEDIN\_GET\_IMAGE**

Tool to retrieve details of a LinkedIn image using its URN. Use when you need to check image status, get download URLs, or access image metadata for a single image.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type   | Required | Example                              | Description                                                                                                                                                  |
| ----------- | ------ | :------: | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `image_urn` | string |     ✅    | `"urn:li:image:C4E10AQFn10iWtKexVA"` | The image URN identifier. Can be provided as 'urn:li:image:XXX' or just the ID 'XXX'. The URN will be URL-encoded automatically when making the API request. |

***

### `Linkedin Get Images`

Integration name: **LINKEDIN\_GET\_IMAGES**

Tool to retrieve image metadata including download URLs, status, and dimensions from LinkedIn's Images API. Use when you need to access image details for posts, profiles, or media library assets.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type  | Required | Example                                | Description                                                                                                                                                                                       |
| --------- | ----- | :------: | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ids`     | array |     ✅    | `["urn:li:image:C4E10AQFn10iWtKexVA"]` | List of image URNs to retrieve. Each URN should be in the format 'urn:li:image:{ID}' (e.g., 'urn:li:image:C4E10AQFn10iWtKexVA'). Maximum recommended batch size depends on LinkedIn's API limits. |

***

### `Linkedin Get My Info`

Integration name: **LINKEDIN\_GET\_MY\_INFO**

Fetches the authenticated LinkedIn user's profile information including name, headline, profile picture, and other profile details.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

*No parameters required.*

***

### `Linkedin Get Network Size`

Integration name: **LINKEDIN\_GET\_NETWORK\_SIZE**

Tool to retrieve the follower count for a LinkedIn organization. Use when you need to get the number of members following a specific company or organization on LinkedIn.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example  | Description                                                                                                                                               |
| ----------------- | ------ | :------: | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `edgeType`        | string |          | —        | The type of network relationship to count. Use COMPANY\_FOLLOWED\_BY\_MEMBER to get follower count.                                                       |
| `organization_id` | string |     ✅    | `"3803"` | The unique identifier for the LinkedIn organization. This is the numeric ID from the organization URN (e.g., for 'urn:li:organization:3803', use '3803'). |

***

### `Linkedin Get Org Page Stats`

Integration name: **LINKEDIN\_GET\_ORG\_PAGE\_STATS**

Tool to retrieve page statistics for a LinkedIn organization page. Use when you need engagement metrics like page views and custom button clicks. Supports both lifetime statistics (all-time data segmented by demographics) and time-bound statistics (aggregate data for specific time ranges). Requires rw\_organization\_admin permission with ADMINISTRATOR role for the organization.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter             | Type    | Required | Example                         | Description                                                                                                                                                         |
| --------------------- | ------- | :------: | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `organization`        | string  |     ✅    | `"urn:li:organization:2414183"` | Organization URN in format urn:li:organization:{id}. Example: urn:li:organization:2414183                                                                           |
| `timeRangeEnd`        | integer |          | `1552003200000`                 | Inclusive ending timestamp in milliseconds since epoch. Only required for time-bound statistics. Omit for lifetime statistics.                                      |
| `timeRangeStart`      | integer |          | `1551398400000`                 | Exclusive starting timestamp in milliseconds since epoch. Only required for time-bound statistics. Omit for lifetime statistics.                                    |
| `timeGranularityType` | string  |          | —                               | Granularity of the statistics. Use DAY for daily statistics or MONTH for monthly statistics. Only required for time-bound statistics. Omit for lifetime statistics. |

***

### `Linkedin Get Person`

Integration name: **LINKEDIN\_GET\_PERSON**

Retrieves a LinkedIn member's profile information by their person ID. Returns lite profile fields (name, profile picture) by default, or basic profile fields (including headline and vanity name) with appropriate permissions.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type   | Required | Example        | Description                                                                                                           |
| ----------- | ------ | :------: | -------------- | --------------------------------------------------------------------------------------------------------------------- |
| `person_id` | string |     ✅    | `"yrZCpj2Z12"` | The unique identifier of the LinkedIn member. Note: Each member id is unique to the context of your application only. |

***

### `Linkedin Get Post Content`

Integration name: **LINKEDIN\_GET\_POST\_CONTENT**

Tool to retrieve detailed post content including text, images, videos, and metadata from LinkedIn by post URN. Use when you need to fetch the full content and details of a specific LinkedIn post.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                                | Description                                                                                                                                            |
| --------- | ------ | :------: | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `post_id` | string |     ✅    | `"urn:li:ugcPost:7428263313739988992"` | Post URN identifier in the format 'urn:li:ugcPost:{id}' or 'urn:li:share:{id}'. Can also be URL-encoded. Example: 'urn:li:ugcPost:7428263313739988992' |

***

### `Linkedin Get Share Stats`

Integration name: **LINKEDIN\_GET\_SHARE\_STATS**

Retrieves share statistics for a LinkedIn organization, including impressions, clicks, likes, comments, and shares. Use to analyze content performance for an organization page. Optionally filter by time intervals to get time-bound statistics.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter               | Type   | Required | Example                                                                         | Description                                                                                                                                                                                                                                                                                                                                                                                                                  |
| ----------------------- | ------ | :------: | ------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `time_intervals`        | string |          | `"(timeRange:(start:1634018799000,end:1634623599000),timeGranularityType:DAY)"` | Time-bound statistics filter in RestLi 2.0 complex object format. Specify time range and granularity as: '(timeRange:(start:\<start\_timestamp>,end:\<end\_timestamp>),timeGranularityType:)' where timestamps are in milliseconds since epoch and GRANULARITY is one of: DAY, WEEK, MONTH. Example: '(timeRange:(start:1634018799000,end:1634623599000),timeGranularityType:DAY)'. If omitted, returns lifetime statistics. |
| `organizational_entity` | string |     ✅    | `"urn:li:organization:2414183"`                                                 | The URN of the organization to retrieve share statistics for. Must be in the format 'urn:li:organization:' where is the organization ID (e.g., 'urn:li:organization:2414183'). Get organization IDs using the GET\_COMPANY\_INFO action.                                                                                                                                                                                     |

***

### `Linkedin Get Videos`

Integration name: **LINKEDIN\_GET\_VIDEOS**

Retrieves video metadata from LinkedIn Marketing API. Supports single video retrieval, batch retrieval (multiple videos), and finding videos by associated account with pagination. Use when you need to get video details including duration, dimensions, status, download URLs, and media library information.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter              | Type    | Required | Example                                                                   | Description                                                                                                                                                                                                             |
| ---------------------- | ------- | :------: | ------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `count`                | integer |          | `10`                                                                      | Number of elements to return for pagination, up to 1,000. Only used with 'associated\_account'. Defaults to 10.                                                                                                         |
| `start`                | integer |          | `0`                                                                       | Index where returned elements begin for pagination. Only used with 'associated\_account'. Defaults to 0.                                                                                                                |
| `video_ids`            | array   |          | `["urn:li:video:C4D10AQE9WE5n4uJKUg","urn:li:video:C5F10AQElP1fVH1Ke6g"]` | List of video URNs for batch retrieval (e.g., \['urn:li:video:C4D10AQE9WE5n4uJKUg', 'urn:li:video:C5F10AQElP1fVH1Ke6g']). Use this for batch retrieval. Mutually exclusive with 'video\_urn' and 'associated\_account'. |
| `video_urn`            | string  |          | `"urn:li:video:C4E10AQGUkQY7trgh-Q"`                                      | Single video URN to retrieve (e.g., 'urn:li:video:C4E10AQGUkQY7trgh-Q'). Use this for single video retrieval. Mutually exclusive with 'video\_ids' and 'associated\_account'.                                           |
| `associated_account`   | string  |          | `"urn:li:sponsoredAccount:123456789"`                                     | Sponsored account URN to find videos by associated account (e.g., 'urn:li:sponsoredAccount:123456789'). Use this to find all videos for an account. Mutually exclusive with 'video\_urn' and 'video\_ids'.              |
| `media_library_status` | string  |          | —                                                                         | Filter by media library status. Only used with 'associated\_account'. When omitted, returns all videos regardless of status.                                                                                            |

***

### `Linkedin Initialize Image Upload`

Integration name: **LINKEDIN\_INITIALIZE\_IMAGE\_UPLOAD**

Tool to initialize an image upload to LinkedIn and return a presigned upload URL plus the resulting image URN. Use when you need to prepare an image upload for LinkedIn posts. After calling this tool, upload the image bytes to the returned upload\_url via PUT request, then use the image URN in CREATE\_LINKED\_IN\_POST action.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                      | Description                                                                                                                                                                                                                                      |
| --------- | ------ | :------: | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `owner`   | string |     ✅    | `"urn:li:person:F6kGF1Uduq"` | Owner URN (person or organization) that will own the uploaded image. Must be in the format 'urn:li:person:{id}' for personal posts or 'urn:li:organization:{id}' for organization posts. Use the GET\_MY\_INFO action to retrieve the person ID. |

***

### `Linkedin List Reactions`

Integration name: **LINKEDIN\_LIST\_REACTIONS**

Retrieves reactions (likes, celebrations, etc.) on a LinkedIn entity such as a share, post, or comment. Use when you need to see who reacted to content and what type of reactions were used.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example                                 | Description                                                                                                                                                                                                                              |
| --------- | ------- | :------: | --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `sort`    | string  |          | —                                       | Sort order for reactions. CHRONOLOGICAL sorts by created date ascending, REVERSE\_CHRONOLOGICAL sorts by created date descending (default), RELEVANCE sorts by relevance to the viewer.                                                  |
| `count`   | integer |          | —                                       | Number of reactions to return per page.                                                                                                                                                                                                  |
| `start`   | integer |          | —                                       | Starting index for pagination (number of reactions to skip).                                                                                                                                                                             |
| `entity`  | string  |     ✅    | `"urn:li:activity:7067167295080394752"` | The URN of the entity (share, post, or comment) to get reactions for. Format: 'urn:li:share:{id}', 'urn:li:ugcPost:{id}', 'urn:li:activity:{id}', or 'urn:li:comment:(activity:{activityId},{commentId})'. Do not URL-encode this value. |

***

### `Linkedin Register Image Upload`

Integration name: **LINKEDIN\_REGISTER\_IMAGE\_UPLOAD**

Tool to initialize a native LinkedIn image upload for feed shares and return a presigned upload URL plus the resulting digital media asset URN. Use when you need to upload an image to attach to a LinkedIn post. After calling this tool, upload the image bytes to the returned upload\_url, then use the asset\_urn in LINKEDIN\_CREATE\_LINKED\_IN\_POST.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                    | Type   | Required | Example                                       | Description                                                                                                                                                                                                                             |
| ---------------------------- | ------ | :------: | --------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `recipe`                     | string |          | `"urn:li:digitalmediaRecipe:feedshare-image"` | The digital media recipe URN specifying the processing recipe for the image. Default is 'urn:li:digitalmediaRecipe:feedshare-image' for feed share images.                                                                              |
| `owner_urn`                  | string |     ✅    | `"urn:li:person:123456789"`                   | URN of the owner entity that will own the uploaded image. Must be in the format 'urn:li:person:{id}' for personal posts or 'urn:li:organization:{id}' for organization posts. Use the GET\_USER\_INFO action to retrieve the person ID. |
| `supported_upload_mechanism` | array  |          | `["SYNCHRONOUS_UPLOAD"]`                      | Array of supported upload mechanisms. If not specified, LinkedIn will return the default mechanism (typically SYNCHRONOUS\_UPLOAD).                                                                                                     |

***

### `Linkedin Search Ad Targeting Entities`

Integration name: **LINKEDIN\_SEARCH\_AD\_TARGETING\_ENTITIES**

Search for ad targeting entities using typeahead search. Use when you need to find targeting entities like geographic locations, job titles, industries, or other targeting criteria for LinkedIn ad campaigns.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter      | Type    | Required | Example                               | Description                                                                                                                                                                                                                             |
| -------------- | ------- | :------: | ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `count`        | integer |          | `10`                                  | Maximum number of results to return per page.                                                                                                                                                                                           |
| `facet`        | string  |     ✅    | `"urn:li:adTargetingFacet:locations"` | Ad targeting facet URN to specify the entity type to search (e.g., 'urn:li:adTargetingFacet:locations' for geographic locations, 'urn:li:adTargetingFacet:titles' for job titles, 'urn:li:adTargetingFacet:industries' for industries). |
| `query`        | string  |     ✅    | `"united states"`                     | Search query string to find targeting entities (e.g., 'united states', 'software engineer', 'technology').                                                                                                                              |
| `start`        | integer |          | `0`                                   | Starting index for pagination, representing the number of initial results to skip.                                                                                                                                                      |
| `queryVersion` | string  |          | —                                     | Query version for the search request.                                                                                                                                                                                                   |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.toolhouse.ai/toolhouse/integrations/linkedin.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
