- Category: social media marketing
- Auth: API_KEY
- Composio-managed OAuth available? N/A
- Tools: 16
- Triggers: 0
- Slug:
TYPEFULLY - Version: 20261101_00
Tools
Create Draft (v2)
Create Draft (v2)
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
List of tag slugs (not names) associated with this draft. Tags must already exist in the social set. Maximum 10 tags.
Whether to generate a public share URL for this draft. When true, anyone with the URL can view the draft content.
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.
Human-readable title for the draft. This is for internal organization only and is not posted to social media.
Output
Create Tag
Create Tag
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
Output
Delete Draft
Delete Draft
Get Current User
Get Current User
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
Get Draft
Get Draft
Get Media Status
Get Media Status
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
Output
Get Queue
Get Queue
Get Queue Schedule
Get Queue Schedule
Initialize Media Upload
Initialize Media Upload
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
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
Output
List Drafts
List Drafts
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
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.
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.
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.
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
Resolve LinkedIn Organization
Resolve LinkedIn Organization
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
Output
Update Draft
Update Draft
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
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.
Whether to generate a public share URL. Omit to keep unchanged.
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.
Human-readable title for the draft. This is for internal organization only and is not posted to social media. Omit to keep unchanged.
Output
Update Queue Schedule
Update Queue Schedule
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
New schedule rules (full replacement). Each rule specifies posting time and applicable days