Skip to main content
Typefully logo
  • Category: social media marketing
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 16
  • Triggers: 0
  • Slug: TYPEFULLY
  • Version: 20261101_00

Tools

Slug: TYPEFULLY_CREATE_DRAFTCreate a draft with platform-specific content for X, LinkedIn, Threads, Bluesky, or Mastodon, saving it, scheduling it, or initiating immediate publication. Immediate publishing is asynchronous; the returned draft status alone does not establish the publication outcome.

Input Parameters

array
List of tag slugs (not names) associated with this draft. Tags must already exist in the social set. Maximum 10 tags.
boolean
Whether to generate a public share URL for this draft. When true, anyone with the URL can view the draft content.
object
required
Configuration for all platforms. At least one platform must be enabled with posts.
string
When to publish: “now” to publish immediately, “next-free-slot” to schedule to your next available slot, or an ISO 8601 datetime string with timezone for a specific future time (e.g., “2025-01-20T14:00:00Z”). Omit to save as draft.
string
Human-readable title for the draft. This is for internal organization only and is not posted to social media.
integer
required
The ID of the social set (account) to create the draft under
string
Plain text scratchpad notes for the draft. Formatting is stripped.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TYPEFULLY_CREATE_TAGCreates 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.

Input Parameters

string
required
Display name for the tag. The slug will be auto-generated from this name.
integer
required
The ID of the social set (account) to create the tag under

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TYPEFULLY_DELETE_DRAFTPermanently 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.

Input Parameters

integer
required
The ID of the draft to delete
integer
required
The ID of the social set (account) containing the draft

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TYPEFULLY_GET_CURRENT_USERGet 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.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TYPEFULLY_GET_DRAFTRetrieve a draft by social set and draft ID, including supported platform content, tags, status, and scheduling information. The response is limited to the fields and platforms modeled by this tool.

Input Parameters

integer
required
Unique identifier of the draft to retrieve
integer
required
ID of the social set (account) containing the draft

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TYPEFULLY_GET_MEDIA_STATUSCheck 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.

Input Parameters

string
required
The unique identifier of the media file (UUID format)
integer
required
The ID of the social set (account) that owns the media

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TYPEFULLY_GET_QUEUEGet queue slots and scheduled and planned drafts for a social set over an inclusive date range, organized by day. Planned drafts are dated but do not publish automatically until confirmed.

Input Parameters

string
required
End date for the queue range (YYYY-MM-DD format in the social set timezone)
string
required
Start date for the queue range (YYYY-MM-DD format in the social set timezone)
integer
required
ID of the social set (account) to get the queue for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TYPEFULLY_GET_QUEUE_SCHEDULEGet the queue schedule rules and timezone for a social set. If no schedule exists yet, the request creates one with default rules.

Input Parameters

integer
required
ID of the social set (account) to get the queue schedule for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TYPEFULLY_GET_SOCIAL_SETGet a social set’s details and supported connected platform account information for X, LinkedIn, Mastodon, Threads, and Bluesky.

Input Parameters

integer
required
Unique identifier for the social set to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TYPEFULLY_INITIALIZE_MEDIA_UPLOADInitialize an upload for an image, video, GIF, or PDF and return a media ID and presigned upload URL. Upload the raw file bytes separately with a PUT request without extra headers, then use the media ID in draft content.

Input Parameters

string
required
Original filename with extension (e.g., ‘image.jpg’, ‘video.mp4’, ‘document.pdf’). Used for MIME type detection. Allowed extensions: .jpg, .jpeg, .png, .webp, .gif, .mp4, .mov, .pdf
integer
required
The ID of the social set (account) to upload media to. Must be a positive integer.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TYPEFULLY_LIST_DRAFTSList 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.

Input Parameters

array
Filter drafts by one or more tag slugs. Call TYPEFULLY_LIST_TAGS to discover valid slugs, then pass a list such as [‘marketing’] or [‘marketing’, ‘launch’]. Omit to include all tags.
integer
Maximum number of drafts to return in this page. Must be between 1 and 50. Defaults to 10.
integer
Number of drafts to skip from the beginning of the list (for pagination). Set to the number of drafts already fetched to get the next page.
string ("draft" | "scheduled" | "published" | "error" | "publishing")
Status filter for drafts. Use scheduled/published to replace the retired v1 recently-scheduled and recently-published endpoints.
string ("-updated_at" | "updated_at" | "-created_at" | "created_at" | "-scheduled_date" | "scheduled_date" | "-published_at" | "published_at")
Sort order for drafts. Prefix with ’-’ for descending order.
integer
required
ID of the Typefully social set (account/team) to list drafts from. Call TYPEFULLY_LIST_SOCIAL_SETS first and use the relevant results[].id; most accounts have exactly one social set.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TYPEFULLY_LIST_SOCIAL_SETSList 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.

Input Parameters

integer
Maximum number of items to return per page
integer
Number of items to skip from the beginning (for pagination)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TYPEFULLY_LIST_TAGSList tags for a social set to organize, filter, or categorize drafts. Results are paginated using limit and offset.

Input Parameters

integer
Maximum number of tags to return per page
integer
Number of tags to skip from the beginning (for pagination)
integer
required
The ID of the social set to list tags for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TYPEFULLY_RESOLVE_LINKED_IN_ORGANIZATIONResolve 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.

Input Parameters

integer
required
The ID of the social set to use for resolving the organization
string
required
Public LinkedIn organization URL (company or school profile)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TYPEFULLY_UPDATE_DRAFTUpdate 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.

Input Parameters

array
List of tag slugs (not names) associated with this draft. Use the /tags endpoint to get available tags with their slugs. Tags must already exist in the social set. Omit to keep unchanged.
boolean
Whether to generate a public share URL. Omit to keep unchanged.
integer
required
The unique identifier of the draft to update
object
Platform configurations for updating a draft. Only provided platforms will be updated.
string
When to publish the draft. Options: “now” to publish immediately, “next-free-slot” to schedule to your next available posting slot, or an ISO 8601 datetime string with timezone for a specific future time (e.g., “2025-01-20T14:00:00Z” for UTC or “2025-01-20T09:00:00-05:00” for EST). Timezone is required. Omit to keep unchanged.
string
Human-readable title for the draft. This is for internal organization only and is not posted to social media. Omit to keep unchanged.
integer
required
The ID of the social set (account) that owns the draft
string
Plain text scratchpad notes for the draft. Formatting is stripped. Omit to keep unchanged.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TYPEFULLY_UPDATE_QUEUE_SCHEDULEReplace 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.

Input Parameters

array
required
New schedule rules (full replacement). Each rule specifies posting time and applicable days
integer
required
ID of the social set (account) to update the schedule for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not