Typefully

These are the Typefully actions available to the apps you build with Snow. Connecting an account does not make Snow run these on its own.

• Create Draft (v2)

  Create a new draft with platform-specific content for multi-platform publishing. Use this action when you need to create a draft that can target multiple social media platforms (X, LinkedIn, Threads, Bluesky, Mastodon) simultaneously. The draft can be saved for later editing, scheduled for a specific time or next available slot, or published immediately. Supports scheduling options via publish_at: "now" for immediate publishing, "next-free-slot" for your next available posting window, or an ISO 8601 datetime string with timezone for a specific scheduled time.

• Create Tag

  Creates a new tag for organizing drafts within a social set in Typefully. Use this action when you need to add a new organizational tag to help categorize and group drafts within a specific social account. The tag's slug is automatically generated from the provided name.

• Delete Draft

  Permanently deletes a draft from Typefully. This action cannot be undone. Use this action when you need to remove a draft that is no longer needed. WARNING: This is a destructive operation. Once deleted, the draft cannot be recovered.

• Get Current User

  Get the current authenticated user's information. Returns user details including profile information, email, signup date, and optional profile image URL. Use this action when you need to retrieve the profile information of the currently authenticated Typefully user, such as for displaying user details or verifying authentication.

• Get Draft

  Retrieves a single draft by its ID with full details including platform-specific content, tags, status, and scheduling information. Use this action when you need to retrieve comprehensive details about a specific draft in Typefully. This action requires both the social_set_id and draft_id path parameters to identify the specific draft.

• Get Media Status

  Check the processing status of an uploaded media file. Use when you need to poll the status of a media file after uploading it. Poll this endpoint until status becomes 'ready' before using the media in drafts. Returns status (processing/ready/failed) and media_urls when ready. This action is read-only and idempotent.

• Get Notifications

  Get notifications from Typefully. Can be filtered by kind (inbox or activity).

• Get Queue

  Get the scheduled content queue for a social set within a date range. Returns upcoming scheduled drafts organized by day with their scheduled times. Use this action when you need to view what content is scheduled for a specific date range for a particular social media account in Typefully.

• Get Queue Schedule

  Get the queue schedule configuration for a social set, including posting slots and timezone settings. Use this action when you need to retrieve the scheduling rules and timezone configuration for a social media account in Typefully.

• Get Recently Published

  Get recently published drafts from Typefully.

• Get Recently Scheduled Drafts

  Get recently scheduled drafts from Typefully.

• Get Social Set

  Get detailed information about a specific social set, including all connected platforms (X, LinkedIn, Mastodon, Threads, Bluesky) with account details and profile information. Use this action when you need to retrieve the details and platform connections for a specific social set by its ID.

• Initialize Media Upload

  Initializes a media upload by returning a presigned URL. Use when you need to upload images, videos, GIFs, or PDFs to attach to draft posts. First call this action to get a `media_id` and `upload_url`. Then PUT your file content directly to the `upload_url`. Finally, use the `media_id` in your draft content to attach the media. This action is idempotent — calling it multiple times with the same parameters will return new (unused) presigned URLs.

• List Drafts

  List drafts for a social set with filtering and sorting options. Use this action when you need to retrieve drafts from a specific social set in Typefully. Supports filtering by status (draft, scheduled, published) and tags, and results are ordered by last edited date (most recent first) by default. Results are paginated with support for limit/offset-based pagination.

• List Social Sets

  List all social sets (groups of connected platform accounts) accessible to the authenticated user. Returns paginated list of social sets with basic info including id, username, name, and profile image. Use this action when you need to retrieve social sets for a user or display available accounts.

• List Tags

  List all tags for a social set. Tags help organize and categorize drafts. Use this action when you need to retrieve all tags associated with a specific social set to organize, filter, or categorize drafts within Typefully.

• Mark Notifications Read

  Mark notifications as read in Typefully. Can be filtered by kind and account_id.

• Resolve LinkedIn Organization

  Resolve a LinkedIn organization from its public URL. Returns the organization URN needed for mentions in LinkedIn posts. Use this action when you need to get the LinkedIn organization identifier to include company or school mentions in posts.

• Update Draft

  Update an existing draft with partial update semantics. Use this action when you need to modify specific fields of an existing draft. Only the fields you provide will be updated; omitted fields remain unchanged. This action supports updating: content/title, scheduling (publish_at), tags, scratchpad notes, sharing options, or platform configurations. Note: Cannot update drafts that have already been published.

• Update Queue Schedule

  Replace the queue schedule configuration for a social set. Defines the posting slots for scheduled content. Use this action when you need to update or configure the posting schedule for a social account, such as changing the days and times when content should be published. This performs a full replacement of the schedule rules — existing rules will be overwritten with the new rules provided.