Skip to content
BeeiveDocs

Public API

Use the Beeive API to create posts, upload media, manage channels and read analytics from your own code.

Base URL

Section titled “Base URL”
https://app.beeive.com/public/v1

Authentication

Section titled “Authentication”

Send your API key in the Authorization header of every request, as is, without a Bearer prefix:

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

Your API key is under Settings → Developers → Access in the Beeive app. API access is included on every paid plan.

Errors

Section titled “Errors”

Errors return a JSON body with a msg field:

Status msg Meaning
401 No API Key found The Authorization header is missing.
401 Invalid API key The key is wrong or has been rotated.
401 Invalid OAuth token The pos_ token is wrong or was revoked.
401 No subscription found The account has no active paid plan.
400 Varies The request is invalid. For posts, the message says which channel rejected it and why.
429 Too many post-creation requests. See Limits.

Limits

Section titled “Limits”
  • Creating posts (POST /posts) is limited to a set number of requests per hour for each account. Over the limit, you get 429 Too Many Requests: wait before retrying. One request can post to several channels at once, so batch where you can.
  • Posts also count toward your plan’s monthly post allowance, just like posts created in the app.
  • Other endpoints aren’t rate-limited.

Endpoints

Section titled “Endpoints”

Channels

Section titled “Channels”
Method Path Description
GET /integrations List connected channels
GET /groups List groups (customers)
GET /integration-settings/:id Get a channel’s rules and settings
POST /integration-trigger/:id Fetch channel-specific data
GET /find-slot/:id Find the next free time slot
GET /social/:provider Get a link to connect a new channel
DELETE /integrations/:id Delete a channel

Posts

Section titled “Posts”
Method Path Description
POST /posts Create a post
GET /posts List posts
DELETE /posts/:id Delete a post
PUT /posts/:id/status Switch between draft and scheduled
PUT /posts/:id/settings Update channel settings
GET /posts/:id/missing Find a published post’s live content
PUT /posts/:id/release-id Link a post to its live content

Media

Section titled “Media”
Method Path Description
POST /upload Upload a file
POST /upload-from-url Upload from a URL

Analytics

Section titled “Analytics”
Method Path Description
GET /analytics/:id Channel analytics
GET /analytics/post/:postId Post analytics

Other

Section titled “Other”
Method Path Description
GET /is-connected Check that your key works. Returns { "connected": true }.
GET /notifications Your account notifications, paginated with ?page=0.