Skip to content
Changelog

Report a bug

Postiz integration: operations for AI agents

Postiz connects to Type.com as an integration. This page lists the 29 operations documented for Claude and Codex in Type.com: 16 read, 7 write, 6 destructive.

About Postiz

Postiz is an agentic social media scheduling tool. It offers everything you need to manage your social media posts, build an audience, capture leads, and grow your business faster with AI.

Categories: Marketing & Social

How to connect Postiz to Type.com

Access
Organization connection: one shared account for the workspace.
MCP
Selected social-publishing operations are not available through Type’s MCP server. Other operations remain available through MCP, subject to your connection’s permissions. These MCP restrictions do not apply within Type.

To add the connection, follow the steps in Space connections.

Documented operations

29 operations. Your connection's permissions determine which operations are available. API references describe the vendor surface; they do not expand your connection's credentials or access.

29 operations listed.

Integrations

  • Read

    List all integrations

    Returns all connected social media channels for your organization.

  • Read

    List all groups (customers)

    Returns all customers (groups) for your organization. Use a group ID to filter the integrations list.

  • Read

    Get OAuth URL for a channel

    Generate an OAuth authorization URL for a given integration. Use this to connect a new social media channel. Only OAuth-based integrations are supported (integrations that require an external URL, such as Mastodon, are not available via this endpoint).

  • Read

    Get integration settings and tools

    Returns the posting rules, maximum content length, settings schema, and available provider tools for a connected channel. Use this to discover which tools can be executed with the trigger endpoint.

  • Read

    Check connection status

    Verify if your API key is valid and connected.

  • Read

    Get connected account

    Returns the workspace these credentials act on. With an OAuth app token it also returns the Postiz user who approved the app, so your integration can show who is connected. API keys belong to the whole workspace, so user is null.

  • Read

    Find next available slot

    Get the next available time slot for posting to a specific channel.

  • Write

    Trigger an integration tool

    Executes a provider-specific tool on a connected channel, for example searching Instagram audio for Reels, listing Discord channels, or fetching Reddit flairs. Discover available tools with the integration settings endpoint.

  • Destructive

    Delete a channel

    Delete a connected channel by its integration ID. Any scheduled posts associated with this channel will also be deleted.

Posts

  • Read

    List posts

    Get posts within a date range.

  • Read

    Get missing content

    When a post has been published but the platform did not return a usable post ID (the releaseId is set to "missing"), this endpoint fetches recent content from the provider so you can match and connect the correct one to the post.

  • Write

    Create a post

    Create or schedule a new post. Each social media platform has its own settings schema.

  • Destructive

    Delete a post by ID

    Delete a post by its ID. The API will look up the post and delete all posts in the same group.

  • Destructive

    Delete a post by group

    Delete all posts in a group by the group identifier.

  • Destructive

    Update release ID

    Updates the releaseId of a post that currently has its release ID set to "missing". This connects the post to its actual published content on the platform, enabling analytics and statistics tracking.

  • Destructive

    Change post status

    Moves a post between draft and schedule state. - schedule → sets the post state to QUEUE and (re)starts the publishing workflow so it will be published at its stored date.

  • Destructive

    Update post settings

    Merges the given keys into the post's existing provider settings. Only the keys you pass are changed; content and publish date are untouched, so a running publishing workflow is not restarted. The merged settings are re-validated.

Analytics

  • Read

    Get platform analytics

    Get analytics data for a specific integration/channel. Returns metrics like followers, impressions, engagement, etc. depending on the platform.

  • Read

    Get post analytics

    Get analytics data for a specific published post. Returns metrics like likes, comments, shares, impressions, etc. depending on the platform.

Uploads

  • Read

    Get media status

    Check whether a file uploaded with adjust set to true finished adjusting. A failed adjustment returns status "ready" with a warning: the original file was kept and is used for publishing.

  • Read

    List media

    List the media files already uploaded to your organization's media library, newest first, 18 per page.

  • Write

    Upload a file

    Upload a media file using multipart form data.

  • Write

    Upload from URL

    Upload a file from an existing URL.

Notifications

  • Read

    List notifications

    Get paginated notifications for your organization, sorted by most recent first. Returns 100 notifications per page.

Video Generation

  • Write

    Generate a video

    Create AI-generated videos for your posts.

  • Write

    Video function

    Execute video-related functions like loading available voices.

Clipping

  • Read

    List clippings

    Get the clippings of your organization, most recent first, 20 per page. The clips themselves are returned by Get a clipping.

  • Read

    Get a clipping

    Get the status of a clipping and its clips. Poll it (every 30 seconds is plenty) until the status is completed or failed. A completed clipping can still carry failed clips: every clip has its own status.

  • Write

    Start a clipping

    Turn a long YouTube video into short vertical clips with burned-in captions. The best parts are picked automatically, every clip is saved to the media library, and when integrations are passed a draft post is created for every clip on every integration.

See How connections work for access and permissions, or browse all integrations.