Changelog

Stay up to date with the latest changes, new features, and improvements to the Oktopost API. We're constantly working to enhance the API experience and add new capabilities.

[Version 2.14.0] - 2026-07-14

Added

Added pagination and sorting parameters (_page, _count, _order) to the List Campaigns and List Users endpoints.
Added q name-search parameter to the List Users endpoint.
Added an Item Types reference table (Conversation, Post, Mention, Reply) to the Conversations documentation, including a callout clarifying that Post refers to a comment.

Fixed

Fixed lowercase conversation ItemType examples in the Conversations and webhook docs to match the PascalCase enum values.

[Version 2.13.0] - 2026-06-21

Added

Added targetingPresetId parameter to Create Post and Update Post for applying LinkedIn audience targeting.
Added workflowId parameter to Create Post for submitting posts into approval workflows.
Added List Targeting Presets endpoint (GET /v2/credential/:id/targeting-presets).
Added "Error Handling" section to MCP Server documentation explaining protocol errors vs tool execution errors.
Added Language field (ISO 639-1 code) to engagement webhook payloads (newConversation, conversationUpdated). Language is automatically detected from conversation content.

Changed

MCP Server error handling updated to follow the MCP specification — tool execution failures now return isError: true in the result instead of JSON-RPC protocol errors, enabling AI clients to read error details and self-correct.

[Version 2.12.0] - 2026-06-15

Added

Added lastSeen, notSeen, and neverSeen activity filter parameters to the List Advocates endpoint.
Added Shares, LastSeen, RoleId, Role, CustomFields, and Leaderboards fields to the List Advocates response when boardId is provided.
Added pagination parameters (_page, _count) documentation for the List Advocates endpoint.

Changed

Renamed the shares sort key from periodLastShares to shares in the Advocates response.
Consolidated advocate filtering documentation into a single parameters table.

[Version 2.11.0] - 2026-06-01

Fixed

Fixed near-past post approval in the Workflow Items approve endpoint — posts with a start time within the last hour no longer fail with an uncaught error.
Fixed error handling for the approve/reject endpoint — invalid approval attempts (e.g. distant-past posts) now return a proper JSON error response instead of a fatal error.
Fixed MessageID field in approval webhook payloads — no longer incorrectly populated for advocacy stories.
Removed hardcoded Network = 'advocacy' from story approval webhook payloads; network is now resolved dynamically.

Added

Added WorkflowItemID, StoryID, and BoardID fields to approval webhook payloads (newApprovalItem, approvalItemApproved, approvalItemRejected).

[Version 2.10.0] - 2026-05-05

Added

Added all_leads boolean parameter to the List Leads endpoint — when true, returns all leads including those without an email address.

[Version 2.9.0] - 2026-04-29

Added

Added new Folders endpoint for managing Media Library folders: list, get, create, rename, and delete.
Added folderId filter parameter to the Media list endpoint for retrieving assets within a specific folder.
Added new Media sidebar section grouping Media, Upload, and Folders.
Added repost story support to POST /v2/story — create LinkedIn repost stories via the optional postlogId parameter. See Stories.
Added PostlogId and Type fields to story GET responses for repost stories.

Changed

Media and Upload documentation moved from the Publishing section to the new Media section. Old URLs under /docs/api/publishing/media and /docs/api/publishing/upload are no longer valid.

[Version 2.8.0] - 2026-04-12

Added

Added new Dashboards endpoints for Social BI: List Dashboards, Get Dashboard, and Get Dashboard Report Data.
Added MCP documentation for new Social BI tools: list_dashboards, get_dashboard, get_dashboard_report_data.
Added MCP "Analytics & Reporting" use-case update with Social BI dashboard example.

[Version 2.7.0] - 2026-03-31

Added

Added MCP documentation for new Inbox tools: list_conversations, get_conversation, update_conversation_status, get_conversation_timeline, assign_conversation, add_conversation_note, update_conversation_tags, reply_to_conversation, create_salesforce_case, list_conversation_tags, get_conversation_tag, update_conversation_tag, delete_conversation_tag, list_canned_responses, get_canned_response, create_canned_response.
Added MCP "Inbox Management" use-case section with examples for triaging DMs, comments, and mentions.

[Version 2.6.0] - 2026-03-30

Added

Added new Inbox section with endpoint documentation for Conversations, Conversation Tags, Canned Responses, and Comments.

[Version 2.5.0] - 2026-03-29

Added

Added MCP documentation for new tools: update_campaign, update_message, list_posts, validate_video_upload, get_workflow, send_to_workflow, remove_from_workflow, get_board, update_board_topic, get_board_story, list_advocates, get_advocate, invite_advocate.
Added MCP documentation for get_post_analytics (new Analytics section).
Added TypeScript SDK link in the sidebar navigation.

Changed

MCP "Feedback" section replaced with "Analytics" section.

Removed

Removed send_feedback MCP tool and related references.

[Version 2.4.0] - 2026-03-25

Added

Added endpoint documentation for Integration Actions — execute operations on connected Salesforce, Marketo, and HubSpot integrations via a unified API.
Added endpoint documentation for Change Post Campaign — move a post to a different campaign.