Channels

In the API, a connected social channel is called an integration. Every post needs the id of at least one.

List channels

GET /public/v1/integrations

Query	Description
`group`	Optional. Only channels in this group (customer).

curl https://app.beeive.com/public/v1/integrations \
  -H "Authorization: YOUR_API_KEY"

[
  {
    "id": "clx1a2b3c0001",
    "name": "Beeive",
    "identifier": "linkedin-page",
    "picture": "https://...",
    "disabled": false,
    "profile": "beeive",
    "customer": { "id": "clx9z8y7x0001", "name": "Acme Inc" }
  }
]

identifier is the network, such as x, linkedin, facebook or instagram. customer only appears when the channel belongs to a group.

List groups

GET /public/v1/groups

Groups (customers) organise channels when you manage several brands or clients.

[{ "id": "clx9z8y7x0001", "name": "Acme Inc" }]

Get channel settings

GET /public/v1/integration-settings/:id

Returns a channel’s posting rules and the settings it accepts. Use it before creating a post with channel-specific options.

{
  "output": {
    "rules": "Text describing the network's posting rules",
    "maxLength": 3000,
    "settings": "No additional settings required",
    "tools": []
  }
}

Field	Description
`rules`	The network’s posting rules in plain text.
`maxLength`	The maximum post length.
`settings`	A JSON schema of the channel’s settings, or `"No additional settings required"`.
`tools`	Helper methods you can call with Fetch channel data.

Fetch channel data

POST /public/v1/integration-trigger/:id

Some settings need data from the network itself, for example which board or page to post to. Call a method listed in tools from Get channel settings:

{ "methodName": "METHOD_FROM_TOOLS", "data": {} }

Find a free slot

GET /public/v1/find-slot/:id

Returns the next free publishing time for a channel, based on its posting schedule:

{ "date": "2026-12-31T09:00:00.000Z" }

Connect a channel

GET /public/v1/social/:provider

Returns a link that starts connecting a new channel of the given network, for example linkedin or x. Send the user to it to finish the connection.

{ "url": "https://..." }

Networks that need extra details at connect time, such as a custom server address, can’t be connected this way. Connect those in the app.

Delete a channel

DELETE /public/v1/integrations/:id

Disconnects the channel. Posts already scheduled on it are deleted too.