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
- Go to Organization > Connectors and find Ordinal.
- Click Enable and choose which tools to allow.
- 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.
| Tool | What it does |
|---|---|
get_analytics_cpm | Read the workspace's cost-per-mille values per platform. |
get_company_workspace | Retrieve one workspace in the company by ID, including its timezone. |
get_idea | Retrieve one idea with its per-channel copy and media. |
get_linkedin_follower_growth | Retrieve follower counts over time for a connected LinkedIn profile, as one data point per recorded day. |
get_linkedin_mention_format | Resolve a LinkedIn vanity name into the '@[Name](urn)' string LinkedIn post copy needs to tag a person or company. |
get_linkedin_post_analytics | Retrieve per-post LinkedIn metrics for a connected profile: impressions, reactions, comments, shares, clicks, video views, engagement rate, and earned media value. |
get_linkedin_profile | Look up a LinkedIn person or company by URN and get their display name, vanity name, and avatar. |
get_post | Retrieve one post with its full per-channel copy, media, labels, and schedule. |
get_post_version | Read the plain-text copy of one saved draft version for one channel. |
get_slack_boost | Retrieve one Slack boost with its message text and target channel. |
get_upload_status | Check an upload job and read its assetId once processing finishes. |
get_webhook | Retrieve one webhook with its delivery URL, subscribed topics, and custom headers. |
get_workspace | Retrieve 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_growth | Retrieve follower counts over time for a connected X profile, as one data point per recorded day. |
get_x_post_analytics | Retrieve per-post X metrics for a connected profile: impressions, likes, replies, retweets, quotes, bookmarks, engagement rate, and earned media value. |
list_company_workspaces | List every workspace in the company. |
list_engagement_profiles | List 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_ideas | List unscheduled ideas, newest first. |
list_invites | List workspace invitations that have not been accepted yet, with who sent each one. |
list_labels | List the labels defined in the workspace, with their IDs and colors. |
list_post_approvals | List the approval requests on a post, showing who was asked, who has signed off, and which requests block publishing. |
list_post_comments | List the team's comments on a post, oldest first, with who wrote each one. |
list_post_engagements | List the likes, comments, and reposts queued on a post for teammates' profiles to perform after it publishes, with their delays. |
list_post_inline_comments | List 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_boosts | List the Slack notifications queued on a post, which channel each goes to, and whether Ordinal added it automatically. |
list_post_subscribers | List the workspace members subscribed to notifications about a post, and who added each of them. |
list_post_versions | List saved draft versions of a post's copy, grouped by channel, with who edited each one. |
list_posts | List posts on the Ordinal calendar, newest first. |
list_scheduling_profiles | List 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_webhooks | List 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_users | List workspace members with the user IDs that create_approvals, add_post_subscribers, and '@[Name](userId)' comment mentions require. |
list_webhooks | List the webhooks configured in the workspace, with their delivery URLs and subscribed event topics. |
list_workspace_api_keys | List the API keys issued for one workspace, with their names and last-used times. |
search_instagram_locations | Search 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_credential | Validate the Ordinal API key with one lightweight read. |
Write (15)
Create or send data.
| Tool | What it does |
|---|---|
add_idea_to_calendar | Promote an idea to a calendar post on a given date, carrying its copy across. |
add_post_subscribers | Subscribe workspace members to notifications about a post. |
create_approvals | Ask 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_workspace | Create a new workspace in the company, optionally seeding it with members. |
create_idea | Create an unscheduled idea with copy for LinkedIn, X, TikTok, or YouTube Shorts. |
create_invite | Invite someone to the workspace by email. |
create_label | Create a workspace label that can then be assigned to posts and ideas. |
create_post | Create a post with copy for one or more channels. |
create_post_comment | Add an internal comment to a post for the team to see. |
create_post_engagements | Queue likes, comments, or reposts that teammates' profiles perform automatically after a post publishes. |
create_slack_boost | Queue a Slack notification asking a channel to go engage with a post when it publishes. |
create_webhook | Create a webhook that POSTs Ordinal events to a URL. |
create_workspace_api_key | Mint a new API key for one workspace. |
prepare_file_upload | Reserve 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_url | Import 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.
| Tool | What it does |
|---|---|
archive_idea | Archive an idea, moving it out of the idea list into the trash. |
archive_post | Archive a post, moving it off the calendar into the trash without publishing it. |
delete_approval | Withdraw an approval request from a post. |
delete_comment | Delete an internal comment from a post. |
delete_engagement | Remove a queued engagement so that profile will not like, comment, or repost when the post publishes. |
delete_invite | Revoke a pending workspace invitation so the link stops working. |
delete_label | Delete a workspace label. |
delete_slack_boost | Remove a Slack boost so no notification is sent for the post. |
delete_subscriber | Unsubscribe a member from a post's notifications. |
delete_webhook | Delete a webhook so Ordinal stops delivering events to it. |
schedule_post | Queue a post to publish, optionally at a new time. |
unarchive_idea | Restore an archived idea back to the idea list. |
unarchive_post | Restore an archived post back onto the calendar. |
unschedule_post | Remove a post from the publishing queue and return it to a draft status. |
update_analytics_cpm | Set the workspace's cost-per-mille values, one or more platforms at a time. |
update_engagement | Change a queued engagement's comment text, delay, profile, or LinkedIn reaction. |
update_idea | Update an idea's title, labels, campaign, notes, or per-channel copy. |
update_post | Update a post's title, publish time, status, labels, notes, or per-channel copy. |
update_slack_boost | Change a Slack boost's message text or move it to a different channel. |
update_webhook | Change a webhook's name, delivery URL, subscribed topics, description, or custom headers. |