Skip to the page

Errors and limits

A Buzzmark API refusal is JSON with a code, a message, whether a retry may work, and a request id, and its HTTP status matches the code.

Each key has its own rate limit, apart from AI apps. A monthly plan quota that runs out answers 429 limit_reached, which waiting a minute doesn't fix.

Errors

A refusal is {"ok": false, "error": {"code", "message", "retryable", "request_id"}}. Build on code, show message to a person, and retry only when retryable is true. Every answer carries the same id in its X-Request-Id header: send it to support@buzzmark.ai when you ask about a request.

CodeStatusRetryWhat it means
bad_request400NoThe body isn't JSON, or a query value can't be read.
idempotency_key_required400NoA POST that creates something needs an Idempotency-Key header.
unauthorized401NoNo key, an unknown key, a revoked or expired key, or the key's maker left the organization.
forbidden403NoThe key's scope or its maker's role doesn't allow this.
not_found404NoNo such endpoint, or no such post, social set or account for this key.
method_not_allowed405NoThe endpoint exists, with another method.
in_flight409YesA request with the same Idempotency-Key is still running.
invalid422NoThe request was read and refused: a field is wrong, or the post breaks a platform's rules.
idempotency_mismatch422NoThe Idempotency-Key was already used with another body.
rate_limited429YesThe key's limit for the minute or the hour is used up. Retry-After says when.
limit_reached429NoA plan's own quota for this ran out. The message says what, and when it starts again.
failed502YesThe posting queue or a platform didn't answer. Nothing was changed.
internal500YesSomething went wrong on Buzzmark's side. Nothing was changed.

Rate limit

Each key has its own limit, apart from AI apps:

A minute60
An hour1,000

Every answer carries RateLimit and RateLimit-Policy headers. Past the limit, the answer is 429 rate_limited with Retry-After in seconds.

Plan quotas

Writing, Hive checks, Scout runs and pictures use your plan's monthly amounts, as in the app. When one runs out, the answer is 429 limit_reached, saying which and when it starts again. It isn't retryable: waiting a minute doesn't bring it back.

PlanGrowthReachScaleAgency
Brands
Each brand is a social set with its own channels, slots and time zone.
131025
Hive profiles
How Buzz knows each brand's voice.
131025
Connected channels52050, then $2 each125
Buzz written for you
New writing Buzz does for you. One piece counts once, however many channels it goes to.
75 a month300 a month600 a month1,500 a month
AI images20 a month100 a month200 a month500 a month
Scout runs
Research on your competitors or the news in your field.
3 a month15 a month60 a month150 a month
Hive checks
A score for how much a draft sounds like you. Up to 8 on one post.
225 a month900 a month1,800 a month4,500 a month
Seats15UnlimitedUnlimited
Engage: comments, DMs and Google reviews in one list
Buzz sorts what needs you first and drafts each reply in your voice. Nothing goes out until you press Send.
Not includedNot includedIncludedIncluded
X comments and messages
X charges for every read. Reading a comment uses 1, a message 2, a reply you send 3. A one-off pack adds 2,000 for $29, kept until you use them.
Not includedNot included2,000 a month5,000 a month
Roles and approval before a post goes outNot includedIncludedIncludedIncluded
Review links for clients, no account neededNot includedNot includedIncludedIncluded
Client reportsNot includedNot includedIncludedIncluded
Connect links for a client's own accounts
Your client signs in to each platform from a link, and the account lands in their brand. Nobody shares a password.
Not includedNot includedIncludedIncluded
Teammates limited to chosen brands
Each teammate sees and works on only the brands you pick for them.
Not includedNot includedIncludedIncluded
Client portal
One address per client with their content plan, feedback and reports. A client gets in with a code sent to their email, never a Buzzmark account.
Not includedNot includedNot includedIncluded
White label
Your name, logo and colour on the portal, review links, connect links and reports, with no Buzzmark mark on them. The sign-in email comes under your agency's name.
Not includedNot includedNot includedIncluded
Scheduled client reports
A weekly or monthly report, or a campaign's when it ends, emailed to the people on the client's portal under your agency's name.
Not includedNot includedNot includedIncluded
Campaigns with their own reportNot includedNot includedNot includedIncluded
Client setup in the portal
Your client answers what shapes their voice: their stories, the posts they like, what they sell. Nothing reaches their Hive until you accept it.
Not includedNot includedNot includedIncluded

Prices, in your currency: buzzmark.ai/pricing

Where to next