GravitySocial icon

GravitySocial

Interact with GravitySocial API

Actions21

Overview

This node integrates with the GravitySocial API to manage tags within a specified workspace. Specifically, the "Tag - Create" operation allows users to create new tags by providing a workspace identifier and tag details such as name and optional color. This is useful for organizing and categorizing social media posts or other entities managed in GravitySocial.

Practical scenarios include:

  • Automatically creating tags to categorize posts based on content themes.
  • Adding color-coded tags for better visual management of social media assets.
  • Integrating tag creation into workflows that prepare social media campaigns.

Properties

Name Meaning
Workspace UUID The unique identifier (UUID) of the workspace where the tag will be created.
Name The name of the tag to be created.
Additional Fields Optional additional properties for the tag. Currently supports:
- Color: The color of the tag in hexadecimal format (e.g., #FF5733).

Output

The node outputs the JSON response from the GravitySocial API after creating the tag. This typically includes the newly created tag's details such as its UUID, name, color, and any other metadata returned by the API.

The output is structured as an array of JSON objects, each representing a tag resource. There is no binary data output for this operation.

Example output snippet (simplified):

[
  {
    "uuid": "tag-uuid-string",
    "name": "Example Tag",
    "hex_color": "#FF5733",
    ...
  }
]

Dependencies

  • Requires an active connection to the GravitySocial API via an API key credential.
  • The node expects the API base URL and access token to be configured in the credentials.
  • The workspace UUID must be provided to specify the context for tag creation.

Troubleshooting

  • Validation Errors: If required fields like Workspace UUID or Name are missing or invalid, the API may return validation errors. The node surfaces these with detailed messages indicating which fields failed validation.
  • Authentication Issues: Ensure the API key credential is valid and has permissions to create tags in the specified workspace.
  • Network or API Errors: HTTP errors such as 4xx or 5xx status codes will be logged with status and response details. Check network connectivity and API service status.
  • Unsupported File Errors: Not applicable for this operation but relevant for media upload operations in the same node.

Links and References

Discussion