---
canonical_url: "https://docs.composio.dev/toolkits/onlysocial"
markdown_url: "https://docs.composio.dev/toolkits/onlysocial.md"
product: "platform"
version: null
last_updated: null
---

# OnlySocial

OnlySocial is a social media management platform for managing accounts, media, tags, posts, and account groups across a workspace.

- **Category:** social media marketing
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 10
- **Triggers:** 0
- **Slug:** `ONLYSOCIAL`
- **Version:** 00000000_00

## Tools

### Create Tag

**Slug:** `ONLYSOCIAL_CREATE_TAG`

Create a named, color-coded tag in the configured OnlySocial workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Tag name. |
| `hex_color` | string | Yes | Tag color in #RGB or #RRGGBB hexadecimal format. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Tag

**Slug:** `ONLYSOCIAL_DELETE_TAG`

Permanently delete one tag from the configured OnlySocial workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tag_uuid` | string | Yes | UUID of the tag to permanently delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Media

**Slug:** `ONLYSOCIAL_GET_MEDIA`

Get one OnlySocial media file by UUID, including its URLs, type, and alt-text metadata returned by the provider.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `media_uuid` | string | Yes | UUID of the media file to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Post

**Slug:** `ONLYSOCIAL_GET_POST`

Get one OnlySocial post by UUID with its accounts, tags, and content versions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `post_uuid` | string | Yes | UUID of the post to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Social Accounts

**Slug:** `ONLYSOCIAL_LIST_ACCOUNTS`

List the social accounts connected to the configured OnlySocial workspace, including provider and authorization status.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Media

**Slug:** `ONLYSOCIAL_LIST_MEDIA`

Return one page of media files from the configured OnlySocial workspace for selection when composing posts.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Requested number of media items in this page. OnlySocial does not document a maximum. |
| `next_cursor` | string | No | Continuation cursor returned by a previous call. Pass it back unchanged; omit it for the first page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Posts

**Slug:** `ONLYSOCIAL_LIST_POSTS`

Return one page of posts from the configured OnlySocial workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `next_cursor` | string | No | Continuation cursor returned by a previous call. Pass it back unchanged; omit it for the first page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Tags

**Slug:** `ONLYSOCIAL_LIST_TAGS`

List all tags in the configured OnlySocial workspace for organizing or filtering posts.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Tag

**Slug:** `ONLYSOCIAL_UPDATE_TAG`

Replace the name and color of an existing OnlySocial tag.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Replacement tag name. |
| `tag_uuid` | string | Yes | UUID of the tag to update. |
| `hex_color` | string | Yes | Replacement tag color in #RGB or #RRGGBB hexadecimal format. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Upload Media

**Slug:** `ONLYSOCIAL_UPLOAD_MEDIA`

Upload an image or video file to the configured OnlySocial workspace for later use in posts.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file` | object | Yes | Image or video file to upload. |
| `alt_text` | string | No | Optional accessibility description for the media. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |