Tools reference

An app only sees the tools its permissions allow. All dates are ISO 8601, for example 2026-07-01 or 2026-07-01T09:00:00Z. Results include a link that opens the item in Kasbly.

Tool	What it does	Permission
get_workspace	Workspace, your role and this connection’s permissions	Any
list_social_accounts	Connected social accounts	See social accounts
list_posts	Find posts with filters	Read posts
get_post	One post with full caption, media and status	Read posts
create_draft_post	Save a new draft for review	Create draft posts
list_campaigns	Always-on campaigns	Read campaigns
get_campaign	One campaign with its settings	Read campaigns
get_posting_summary	Post counts by status for a period	Read results
get_account_insights	What works for one account over 90 days	Read results
list_workflows	Automation workflows	Read workflows
get_workflow	One workflow with its trigger and steps	Read workflows

get_workspace

Call this first. Returns the workspace name, your role, the permissions of this connection and the tools available. No inputs.

list_social_accounts

Input	Type	Notes
platform	string, optional	e.g. INSTAGRAM, FACEBOOK, TIKTOK
limit	number, optional	1 to 100, default 50

Use an account id from here as accountId in create_draft_post.

list_posts

Input	Type	Notes
status	string, optional	DRAFT, SCHEDULED, PUBLISHING, PUBLISHED, FAILED
approvalStatus	string, optional	PENDING, IN_REVIEW, APPROVED, REJECTED, CHANGES_REQUESTED
platform	string, optional	Social platform
accountId	string, optional	One social account
campaignId	string, optional	One campaign
search	string, optional	Text in the title or caption
from, to	date, optional	Date range
page, pageSize	number, optional	pageSize up to 50, default 20

get_post

Input	Type	Notes
postId	string	From list_posts

create_draft_post

Saves a draft and returns it with a link. Nothing is scheduled or published; a person reviews it on the Marketing board.

Input	Type	Notes
accountId	string	From list_social_accounts
content	string, optional	The caption
title	string, optional	Internal title
platformCaptions	object, optional	A different caption per platform
targetPlatforms	list, optional	Platforms to post to; defaults to the account’s
mediaUrls	list, optional	Up to 10 image or video URLs

Provide content or at least one media URL. Some platforms, such as Instagram, need media.

list_campaigns and get_campaign

list_campaigns has no inputs. get_campaign takes campaignId.

get_posting_summary

Input	Type	Notes
from, to	date, optional	Date range
accountId	string, optional	One social account

Returns post counts per status and how many posts are awaiting review.

get_account_insights

Input	Type	Notes
accountId	string	From list_social_accounts

Returns which hooks, formats and sources beat the account’s median engagement over the last 90 days, and which lag.

list_workflows and get_workflow

list_workflows has no inputs. get_workflow takes workflowId.