Skip to main content

Ordinal

Social media management — draft, schedule, approve, and analyze posts across LinkedIn, X, Instagram, TikTok, and YouTube Shorts.

Categories: Marketing, Analytics, Collaboration

What you can ask​

  • Draft a LinkedIn post from a product update and schedule it for Tuesday at 9am
  • Pull post analytics for last month's X posts and rank them by engagement
  • List posts waiting on approval and notify each reviewer

Set up​

Ordinal connects with credentials from your Ordinal account. Have these values ready:

  • API key
  1. Go to Organization > Connectors and find Ordinal.
  2. Click Enable and choose which tools to allow.
  3. Each member enters their own values the first time they use it.

To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.

Tools​

Ordinal offers 70 tools. Admins choose which ones agents can use. See Tool permission groups.

Read (35)​

View and search information without changing it.

ToolWhat it does
get_analytics_cpmRead the workspace's cost-per-mille values per platform.
get_company_workspaceRetrieve one workspace in the company by ID, including its timezone.
get_ideaRetrieve one idea with its per-channel copy and media.
get_linkedin_follower_growthRetrieve follower counts over time for a connected LinkedIn profile, as one data point per recorded day.
get_linkedin_mention_formatResolve a LinkedIn vanity name into the '@[Name](urn)' string LinkedIn post copy needs to tag a person or company.
get_linkedin_post_analyticsRetrieve per-post LinkedIn metrics for a connected profile: impressions, reactions, comments, shares, clicks, video views, engagement rate, and earned media value.
get_linkedin_profileLook up a LinkedIn person or company by URN and get their display name, vanity name, and avatar.
get_postRetrieve one post with its full per-channel copy, media, labels, and schedule.
get_post_versionRead the plain-text copy of one saved draft version for one channel.
get_slack_boostRetrieve one Slack boost with its message text and target channel.
get_upload_statusCheck an upload job and read its assetId once processing finishes.
get_webhookRetrieve one webhook with its delivery URL, subscribed topics, and custom headers.
get_workspaceRetrieve the workspace this API key belongs to: name, slug, and the IANA timezone that publishDate values and the calendar are expressed in.
get_x_follower_growthRetrieve follower counts over time for a connected X profile, as one data point per recorded day.
get_x_post_analyticsRetrieve per-post X metrics for a connected profile: impressions, likes, replies, retweets, quotes, bookmarks, engagement rate, and earned media value.
list_company_workspacesList every workspace in the company.
list_engagement_profilesList the connected social accounts that can like, comment, and repost on behalf of the team, with the profile IDs create_post_engagements and update_engagement require.
list_ideasList unscheduled ideas, newest first.
list_invitesList workspace invitations that have not been accepted yet, with who sent each one.
list_labelsList the labels defined in the workspace, with their IDs and colors.
list_post_approvalsList the approval requests on a post, showing who was asked, who has signed off, and which requests block publishing.
list_post_commentsList the team's comments on a post, oldest first, with who wrote each one.
list_post_engagementsList the likes, comments, and reposts queued on a post for teammates' profiles to perform after it publishes, with their delays.
list_post_inline_commentsList inline comment threads on a post, each anchored to a highlighted piece of draft copy, with its replies and whether it is resolved.
list_post_slack_boostsList the Slack notifications queued on a post, which channel each goes to, and whether Ordinal added it automatically.
list_post_subscribersList the workspace members subscribed to notifications about a post, and who added each of them.
list_post_versionsList saved draft versions of a post's copy, grouped by channel, with who edited each one.
list_postsList posts on the Ordinal calendar, newest first.
list_scheduling_profilesList the connected social accounts posts can publish from, with the profile IDs that create_post, update_post, create_idea, and the analytics tools require.
list_slack_webhooksList the Slack channels connected to the workspace, with the slackWebhookId values create_slack_boost and update_slack_boost require, and whether each notifies by default.
list_usersList workspace members with the user IDs that create_approvals, add_post_subscribers, and '@[Name](userId)' comment mentions require.
list_webhooksList the webhooks configured in the workspace, with their delivery URLs and subscribed event topics.
list_workspace_api_keysList the API keys issued for one workspace, with their names and last-used times.
search_instagram_locationsSearch Instagram locations by name for the pageId that tagging a location on an Instagram Feed or Reel post needs, e.g. 'Ferry Building San Francisco'.
validate_credentialValidate the Ordinal API key with one lightweight read.

Write (15)​

Create or send data.

ToolWhat it does
add_idea_to_calendarPromote an idea to a calendar post on a given date, carrying its copy across.
add_post_subscribersSubscribe workspace members to notifications about a post.
create_approvalsAsk one or more workspace members to approve a post, optionally with a note, due date, and a blocking flag that stops publishing until they sign off.
create_company_workspaceCreate a new workspace in the company, optionally seeding it with members.
create_ideaCreate an unscheduled idea with copy for LinkedIn, X, TikTok, or YouTube Shorts.
create_inviteInvite someone to the workspace by email.
create_labelCreate a workspace label that can then be assigned to posts and ideas.
create_postCreate a post with copy for one or more channels.
create_post_commentAdd an internal comment to a post for the team to see.
create_post_engagementsQueue likes, comments, or reposts that teammates' profiles perform automatically after a post publishes.
create_slack_boostQueue a Slack notification asking a channel to go engage with a post when it publishes.
create_webhookCreate a webhook that POSTs Ordinal events to a URL.
create_workspace_api_keyMint a new API key for one workspace.
prepare_file_uploadReserve an upload slot and get signed credentials for sending local file bytes to Ordinal yourself, as a multipart POST to the returned uploadUrl.
upload_file_from_urlImport an image or video from a public URL so it can be attached to a post.

Delete or overwrite (20)​

Remove or replace existing data.

ToolWhat it does
archive_ideaArchive an idea, moving it out of the idea list into the trash.
archive_postArchive a post, moving it off the calendar into the trash without publishing it.
delete_approvalWithdraw an approval request from a post.
delete_commentDelete an internal comment from a post.
delete_engagementRemove a queued engagement so that profile will not like, comment, or repost when the post publishes.
delete_inviteRevoke a pending workspace invitation so the link stops working.
delete_labelDelete a workspace label.
delete_slack_boostRemove a Slack boost so no notification is sent for the post.
delete_subscriberUnsubscribe a member from a post's notifications.
delete_webhookDelete a webhook so Ordinal stops delivering events to it.
schedule_postQueue a post to publish, optionally at a new time.
unarchive_ideaRestore an archived idea back to the idea list.
unarchive_postRestore an archived post back onto the calendar.
unschedule_postRemove a post from the publishing queue and return it to a draft status.
update_analytics_cpmSet the workspace's cost-per-mille values, one or more platforms at a time.
update_engagementChange a queued engagement's comment text, delay, profile, or LinkedIn reaction.
update_ideaUpdate an idea's title, labels, campaign, notes, or per-channel copy.
update_postUpdate a post's title, publish time, status, labels, notes, or per-channel copy.
update_slack_boostChange a Slack boost's message text or move it to a different channel.
update_webhookChange a webhook's name, delivery URL, subscribed topics, description, or custom headers.
⌘J