> Markdown versions of all pages of this connector library are available by appending `.md` to the page URL. For the full index of connectors, see [llms.txt](https://connectors.appmixer.com/llms.txt).

# Get Channel

- Component: `appmixer.buffer.core.GetChannel`
- Kind: Action
- Version: 1.0.0
- Visibility: Public
- Connector: [appmixer.buffer 1.0.0](https://connectors.appmixer.com/connector/appmixer.buffer/1.0.0.md)
- Component page: <https://connectors.appmixer.com/connector/appmixer.buffer/1.0.0/component/appmixer.buffer.core.GetChannel>

Retrieve a channel (a connected social profile) by its ID.

## Input ports

### Port `in`

| Field | Type | Description |
| --- | --- | --- |
| Channel (`channelId`) | text | Pick a channel (a connected social profile), or type its Channel ID. |

## Output ports

### Port `out`

| Field | Type | Description |
| --- | --- | --- |
| Channel ID (`id`) | string | - |
| Name (`name`) | string | - |
| Display Name (`displayName`) | string | - |
| Service (`service`) | string | - |
| Type (`type`) | string | - |
| Descriptor (`descriptor`) | string | - |
| Avatar (`avatar`) | string | - |
| Organization ID (`organizationId`) | string | - |
| Timezone (`timezone`) | string | - |
| Is Disconnected (`isDisconnected`) | boolean | - |
| Is Locked (`isLocked`) | boolean | - |
| Is Queue Paused (`isQueuePaused`) | boolean | - |
| External Link (`externalLink`) | string | - |
| Created At (`createdAt`) | string | - |
| Updated At (`updatedAt`) | string | - |

## Full metadata (component.json)

```json
{
  "name": "appmixer.buffer.core.GetChannel",
  "label": "Get Channel",
  "description": "Retrieve a channel (a connected social profile) by its ID.",
  "author": "Appmixer <info@appmixer.com>",
  "version": "1.0.0",
  "auth": {
    "service": "appmixer:buffer"
  },
  "quota": {
    "manager": "appmixer:buffer",
    "resources": "requests",
    "scope": {
      "userId": "{{userId}}"
    }
  },
  "inPorts": [
    {
      "name": "in",
      "schema": {
        "type": "object",
        "properties": {
          "channelId": {
            "type": "string"
          }
        },
        "required": [
          "channelId"
        ]
      },
      "inspector": {
        "inputs": {
          "channelId": {
            "type": "text",
            "index": 1,
            "label": "Channel",
            "tooltip": "Pick a channel (a connected social profile), or type its Channel ID.",
            "source": {
              "url": "/component/appmixer/buffer/core/ListChannels?outPort=out",
              "data": {
                "properties": {
                  "isSource": true
                },
                "transform": "./ListChannels#toSelectArray"
              }
            }
          }
        }
      }
    }
  ],
  "outPorts": [
    {
      "name": "out",
      "schema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "Channel ID",
            "example": "5f8e1c2b3a4d5e6f7a8b9c0d"
          },
          "name": {
            "type": "string",
            "title": "Name",
            "example": "acme"
          },
          "displayName": {
            "type": "string",
            "title": "Display Name",
            "example": "Acme Inc."
          },
          "service": {
            "type": "string",
            "title": "Service",
            "example": "linkedin"
          },
          "type": {
            "type": "string",
            "title": "Type",
            "example": "page"
          },
          "descriptor": {
            "type": "string",
            "title": "Descriptor",
            "example": "LinkedIn Page"
          },
          "avatar": {
            "type": "string",
            "title": "Avatar",
            "example": "https://example.com/avatars/acme.png"
          },
          "organizationId": {
            "type": "string",
            "title": "Organization ID",
            "example": "5e7a1b2c3d4e5f6a7b8c9d0e"
          },
          "timezone": {
            "type": "string",
            "title": "Timezone",
            "example": "Europe/London"
          },
          "isDisconnected": {
            "type": "boolean",
            "title": "Is Disconnected",
            "example": false
          },
          "isLocked": {
            "type": "boolean",
            "title": "Is Locked",
            "example": false
          },
          "isQueuePaused": {
            "type": "boolean",
            "title": "Is Queue Paused",
            "example": false
          },
          "externalLink": {
            "type": "string",
            "title": "External Link",
            "example": "https://www.linkedin.com/company/acme"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "title": "Created At",
            "example": "2025-01-15T10:30:00.000Z"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "title": "Updated At",
            "example": "2026-02-01T08:00:00.000Z"
          }
        }
      }
    }
  ],
  "icon": "(data URI omitted)"
}
```
