View as Markdown
Circle icon

Circle ACTION

Create Post

Create a new post in a selected space within your Circle community. See the documentation
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Circle account once, then configure and run Create Post from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "circle-create-post",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    circle: { authProvisionId: "apn_xxxxxxx" },
    communityId: "Community ID",
    spaceId: "Space ID",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Create Post inputs
Property Type Description
communityId Community ID string
Select the community you want to interact with.
Required Dynamic
spaceId Space ID string
Select the space within the community.
Required Dynamic
status Status string
The post's status. Default is published
Optional
publishedAt Published At string
Acts as the publish time and is required when status is scheduled. Must be in the past when status is published. Format: YYYY-MM-DDTHH:MM:SS.SSSZ
Optional
name Name string
The name of the post
Required
body Body string
The body of the post.
Required
isPinned Is Pinned boolean
Whether the post is pinned to the top or not.
Required
isCommentsEnabled Is Comments Enabled boolean
Whether comments are shown or not.
Required
isCommentsClosed Is Comments Closed boolean
Whether users can comment or not.
Required
isLikingEnabled Is Liking Enabled boolean
Whether links are enabled or not.
Optional
userEmail User Email string
Email of the community member to post from. Defaults to admin if empty.
Optional Dynamic

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
circle-create-post
Version
0.0.4
App
Circle
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes