Checking authentication...

Spaces

Create and manage workspaces and their members

8 tools

Add Member To Space

Write

POST /v1/tools/podio/addMemberToSpace

Add members to a workspace by user ID, profile ID, or email address. Assign a role (admin, regular, light) and optionally include a personalized invitation message. Returns 403 if the space user limit is reached.

Parameters

Name	Type	Required	Description
`space_id`	number	required	The workspace/space ID to add members to
`role`	string	required	Role for the new members: "admin" (full access), "regular" (standard member), or "light" (limited access) Values: admin, regular, light
`users`	array	optional	Array of user IDs to add to the space
`profiles`	array	optional	Array of profile IDs to invite to the space
`mails`	array	optional	Array of email addresses to invite (new or existing Podio users)
`message`	string	optional	Personalized message to include in the invitation
`external_contacts`	array	optional	External contacts to invite

Request

curl -X POST https://api.syncello.io/v1/tools/podio/addMemberToSpace \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "space_id": "123",
  "role": "admin"
}'

Response

// Example response not yet documented for this tool.
// The body is the tool's result payload; errors return { "error": "..." }.

Try It

Try it

Create Space

Write

POST /v1/tools/podio/createSpace

Create a new workspace in an organization. Returns the new space_id. Use getOrganizations first to find org_id.

Parameters

Name	Type	Required	Description
`org_id`	number	required	Organization ID
`name`	string	required	Workspace name
`privacy`	string	optional	"closed" (members only, default) or "open" (all org members can see) Values: open, closed
`auto_join`	boolean	optional	Auto-add new employees
`post_on_new_app`	boolean	optional	Announce new apps
`post_on_new_member`	boolean	optional	Announce new members

Request

curl -X POST https://api.syncello.io/v1/tools/podio/createSpace \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "org_id": "123",
  "name": "example"
}'

Response

{
  "space_id": 7482915,
  "url": "https://podio.com/acme-corp/new-workspace",
  "full_url": "https://podio.com/acme-corp/new-workspace"
}

Try It

Try it

End Space Memberships

Destructive

POST /v1/tools/podio/endSpaceMemberships

Remove one or more members from a workspace. Works for both active members and pending invitations. Use getSpaceMembers first to find user IDs.

Parameters

Name	Type	Required	Description
`space_id`	number	required	The workspace/space ID
`user_ids`	array	required	Array of user IDs to remove from the space

Request

curl -X POST https://api.syncello.io/v1/tools/podio/endSpaceMemberships \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "space_id": "123",
  "user_ids": "..."
}'

Response

{
  "status": "ok"
}

Try It

Try it

Get Space

Read Idempotent

POST /v1/tools/podio/getSpace

Get workspace details by ID. Returns space_id, name, org_id, url, privacy, and type by default. Use verbose for the full Podio response.

Parameters

Name	Type	Required	Description
`space_id`	number	required	Space ID
`verbose`	boolean	optional	Return the full Podio response instead of concise summary

Request

curl -X POST https://api.syncello.io/v1/tools/podio/getSpace \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "space_id": "123"
}'

Response

{
  "space_id": 7482910,
  "name": "Sales",
  "org_id": 8471023,
  "url": "https://podio.com/acme-corp/sales",
  "privacy": "closed",
  "type": "regular"
}

Try It

Try it

Get Space Members

Read Idempotent

POST /v1/tools/podio/getSpaceMembers

Get members of a workspace. Returns user profiles with their role (admin, regular, light) and employee status. Supports filtering by member type and searching by name. NOTE: Each member has both user_id and profile_id — for contact fields in createItem/updateItem, always use the profile_id.

Parameters

Name	Type	Required	Description
`space_id`	number	required	The workspace/space ID
`member_type`	string	optional	Filter by member type Values: employee, external, admin, regular, light, guest
`query`	string	optional	Search term to match members by name
`limit`	number	optional	Max results to return (default: 100)
`offset`	number	optional	Pagination offset (default: 0)

Request

curl -X POST https://api.syncello.io/v1/tools/podio/getSpaceMembers \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "space_id": "123"
}'

Response

[
  {
    "employee": true,
    "grants": 0,
    "is_partner": false,
    "role": "admin",
    "profile": {
      "profile_id": 4455667,
      "user_id": 1122334,
      "name": "Jane Doe",
      "mail": [
        "jane@example.com"
      ],
      "type": "user"
    }
  }
]

Try It

Try it

Update Space

Write

POST /v1/tools/podio/updateSpace

Update workspace settings. Only include fields you want to change. Use getSpace first to see current values.

Parameters

Name	Type	Required	Description
`space_id`	number	required	Space ID
`name`	string	optional	New name
`privacy`	string	optional	Privacy level Values: open, closed
`auto_join`	boolean	optional	Auto-add new employees
`url_label`	string	optional	URL slug
`post_on_new_app`	boolean	optional	Announce new apps
`post_on_new_member`	boolean	optional	Announce new members

Request

curl -X POST https://api.syncello.io/v1/tools/podio/updateSpace \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "space_id": "123"
}'

Response

{
  "updated": true,
  "space_id": 7900026
}

Try It

Try it

Update Space Memberships

Write

POST /v1/tools/podio/updateSpaceMemberships

Update the role of one or more members on a workspace. Use getSpaceMembers first to find user IDs.

Parameters

Name	Type	Required	Description
`space_id`	number	required	The workspace/space ID
`user_ids`	array	required	Array of user IDs to update
`role`	string	required	The new role: "admin" (full access), "regular" (standard member), or "light" (limited access) Values: admin, regular, light

Request

curl -X POST https://api.syncello.io/v1/tools/podio/updateSpaceMemberships \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "space_id": "123",
  "user_ids": "...",
  "role": "admin"
}'

Response

{
  "status": "ok"
}

Try It

Try it

Delete Space

Destructive

POST /v1/tools/podio/deleteSpace

Permanently delete a workspace. Cannot be undone. Ends all memberships and cancels pending invites. Use getSpace first to verify the correct workspace.

Parameters

Name	Type	Required	Description
`space_id`	number	required	Space ID

Request

curl -X POST https://api.syncello.io/v1/tools/podio/deleteSpace \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "space_id": "123"
}'

Response

{
  "deleted": true,
  "space_id": 7482910
}