ContentStudio

Integrate with ContentStudio API
Join our community

Actions5

Overview

This node integrates with the ContentStudio API to manage social media accounts and related data within workspaces. Specifically, for the Social Account - List operation, it retrieves a paginated list of social media accounts associated with a specified workspace. Users can optionally filter the accounts by platform (e.g., Facebook, Twitter).

This operation is useful when you want to:

  • Display or process all social accounts linked to a particular workspace.
  • Filter accounts by platform to target specific social networks.
  • Automate workflows that require fetching account details before posting content or analyzing social presence.

Example use case:
A marketing automation workflow that first lists all Facebook and Twitter accounts in a workspace, then schedules posts to those accounts.

Properties

Name Meaning
Workspace ID The unique identifier of the workspace from which to list social accounts.
Page The page number of results to retrieve (pagination). Minimum value is 1.
Per Page Number of social accounts to return per page. Minimum 1, maximum 100.
Platform Optional filter to list only social accounts belonging to a specific platform (e.g., Facebook, Twitter).

Output

The output is an array of JSON objects representing social accounts retrieved from the ContentStudio API. Each object contains details about a social account such as its ID, name, platform, and other metadata provided by the API.

The output structure corresponds directly to the API response for listing accounts under a workspace. It does not include binary data.

Dependencies

  • Requires an active connection to the ContentStudio API using a valid API key credential.
  • The node uses the base URL of the ContentStudio API and requires network access to this service.
  • Pagination parameters (page and perPage) control the amount of data fetched per request.
  • The "Workspace ID" must be selected from available workspaces loaded dynamically via the node's options.

Troubleshooting

  • Missing or invalid Workspace ID: The node requires a valid workspace ID. Ensure the workspace exists and is accessible with your API credentials.
  • API Key errors: If authentication fails, verify that the API key credential is correctly configured and has necessary permissions.
  • Pagination issues: Requesting pages beyond the available range may return empty results. Adjust page and perPage accordingly.
  • Platform filter returns no results: Confirm that the platform string matches supported platforms exactly; otherwise, no accounts will be returned.
  • Timeouts or network errors: Check network connectivity and API availability if requests time out or fail.

Links and References

Discussion