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.20.1] - 2026-10-04

Added

• Documented MCP delete_media. Deleting a media asset by ID archives it when a message still references it, and leaves it attached to that message.
• Documented optional folderId on Create Media. Omit it or leave it empty to create the asset at the root. Pass a folder ID to create it in that folder. An unknown folder returns 400.
• Documented Update Media (PUT /v2/media/{id}). This endpoint supports folderId only. A folder ID moves the asset into that folder, an empty value moves it to the root, and omitting folderId leaves the folder unchanged. An unknown folder returns 400.

[Version 2.20.0] - 2026-10-01

Added

• Documented filter, search, and pagination parameters on Get Stories (GET /v2/story): boardId, status, approveStatus, createdBy, topicIds, tagIds, isFeatured, isRepost, q, _page, _count, and _order. The default page size is 20 and the default sort is publishDate,0. Omitting boardId lists stories on every non-archived board.

Changed

• Noted that MCP list_board_stories still only accepts boardId.

[Version 2.19.3] - 2026-09-29

Added

• Documented inbox webhook Data shapes for Conversation, Post, Mention, and Reply items. See Inbox item Data.
• Noted that inbox webhook Origin can be incorrect for Facebook personal profiles, because Facebook returns a different profile ID on mentions and comments than the ID used when the profile is connected to Oktopost.

[Version 2.19.2] - 2026-09-29

Changed

• Documented the Calendar 60-day window, the unpaginated response, the full message body, and Postlogs (without RemoteId). Documented the campaignTags, messageTags, teams, hasFirstComment, promotion, and showArchived filters.
• Documented List Posts withPostlogs, withMessages, withCampaigns, and withTags, and Get Post postlogs.
• Documented Post Log RemoteId, RemoteUrl, per-profile entries, and Status values. Listing postlogs requires postId and has no date range.
• Corrected webhook delivery docs: the body is a JSON array, and the signature is an HMAC-SHA1 of that raw body in X-Oktopost-Secret. postSent Postlogs include PostURL and do not include RemoteId.
• Documented NetworkAccountId on Social Profiles.
• Documented tag length limits.
• Documented the 1024-character limit and board display lengths for story title and description.

[Version 2.19.1] - 2026-08-31

Changed

• Updated inbox webhook payload examples.

[Version 2.19.0] - 2026-08-30

Added

• Added List Webhook Events (GET /v2/webhook/events) and Get Webhook Event (GET /v2/webhook/events/:event).

[Version 2.18.0] - 2026-08-23

Added

• Added First Comment.
• Added Bulk Invite Advocates documentation for POST /v2/advocate/bulk, including the 100-entry cap, mixed invite/re-invite entries, and partial Errors responses.
• Added application/pdf as a supported mimeType on Create Upload.
• Added PDF to the List Media type filter.
• MCP create_upload now accepts application/pdf; MCP list_media type includes PDF.

Changed

• Updated Invite Advocates for re-invite via userId, optional message/role/customFields, and the Users response shape.

[Version 2.17.0] - 2026-08-17

Added

• Added New Inbox Webhook Events.

[Version 2.16.0] - 2026-08-10

Added

• Added top-level PostlogId to Lead Activity list responses — the published post ID associated with each activity, or null when no post association exists.
• Added a response fields table for the Lead Activity list endpoint.
• Added a newLeadActivity webhook payload example that includes PostlogId. See Webhooks.

[Version 2.15.0] - 2026-07-30

Added

• Added Custom Calendar Events documentation for /v2/calendar/custom-events, including get, create, update, and delete examples with request parameters and response schema.
• Added CustomEvents field to the Get Calendar response.

[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.

[Version 2.3.0] - 2026-03-02

Fixed

• Post update and delete examples now use v2/ API version.
• Webhook signature verification example uses SHA-1 instead of SHA-256.

Added

• Added callout to List Leads endpoint clarifying it returns only non-deleted Leads with a valid email address.

[Version 2.2.0] - 2026-01-02

Added

• Added endpoint documentation for workflow item notes.

[Version 2.1.0] - 2025-12-14

Added

• Added RemoteLeads field to the LIST and GET lead API.

[Version 2.0.0] - 2025-11-25

Changed

• Documentation - Complete API documentation overhaul with enhanced examples and use cases

---

Changelog Format

We follow these conventions for changelog entries:

• Added - New features and endpoints
• Changed - Changes to existing functionality
• Fixed - Bug fixes
• Deprecated - Features that will be removed in future versions
• Removed - Features that have been removed
• Security - Security improvements and vulnerability fixes
• Breaking Changes - Changes that require code updates

Version Numbering

We use Semantic Versioning:

• Major (x.0.0) - Breaking changes
• Minor (0.x.0) - New features, backwards compatible
• Patch (0.0.x) - Bug fixes, backwards compatible