How to connect Reddit Ads to Hermes Agent

Pairing is a two-step handshake: run hermes clawlink begin, approve the link in your browser, then run hermes clawlink finish. If you ran finish before approving, or the approval link expired, run hermes clawlink begin again to get a fresh link. Confirm the plugin was installed with --enable, then verify with hermes clawlink test.

Reconnect Reddit Ads from the dashboard, then start a fresh chat if the runtime still has the old tool catalog loaded.

Reddit Ads tool schemas load on demand the first time a tool runs and are cached after that, so this error usually clears on its own: wait a few seconds and retry the same request. If every Reddit Ads call keeps failing with it in a fresh chat, reconnect from the dashboard, and contact support if it still persists — that pattern points to a configuration problem on our side, not something you can fix by reconnecting again.

Two usual causes. The connected account may not have access to the specific workspace, inbox, store, or project in the request — check that first. If access looks right, the agent may have sent a placeholder value (like "YOUR_ID" or an example id from documentation) instead of a real one: ask it to run a list or search tool first, then retry the action with a real id from those results. Most failures at this stage are one of these two, not ClawLink bugs.

The advice you will find for this assumes you built the integration: check that your token carries the adsread and adsedit scopes, clear the cached token, re-run the OAuth exchange. On this connection the scopes were settled when you approved access, so an empty result almost always means the connected Reddit account is not associated with the ad account. Reddit assigns ad-account access to people through the business that owns it, so a brand new account, or one that was removed from a business, sees nothing while the connection itself reports healthy. Fix it in Reddit Ads by adding your account to the business with a role that covers ads, then retry. The second cause is a placeholder argument: an agent that has not listed anything yet invents an ad account id, and because Reddit's ids are opaque strings the call reaches the API and returns forbidden. Run reddit_ads_get_me and reddit_ads_list_my_businesses first.

Ask the agent to diagnose it:

Run reddit_ads_get_me and tell me which Reddit account is connected. Then run reddit_ads_list_my_businesses and reddit_ads_list_ad_accounts_by_business and show me exactly what came back, including empty lists. Do not retry the failing call until all three have returned.

There is no token in your possession to regenerate, so the usual checklist does not apply. On a hosted connection this means the stored authorization stopped being valid on Reddit's side, and the short list of ways that happens is: you revoked the application in your Reddit account settings, you changed your Reddit password, or your account was removed from the business that owns the ad account. Reconnect Reddit Ads from the ClawLink dashboard to replace the authorization. If the same error returns straight after reconnecting, the cause is on the Reddit account rather than the connection, and opening Reddit Ads in a browser as the same account will usually show it.

Ask the agent to diagnose it:

Run reddit_ads_get_me and report the exact error body if it fails. Do not retry the other Reddit Ads calls.

If the name looks right, the catalog had not loaded when the first call went out; schemas load on demand and one retry usually fixes it. If the agent is asking for something like submitting a post or reading a subreddit feed, it is on the wrong integration: this connection covers advertising, and organic Reddit posting and reading live on the separate Reddit integration. Note also that reddit_ads_create_post and reddit_ads_list_posts here refer to promoted posts within an ad account rather than to organic submissions. Most search results for this phrase say Reddit has no official MCP server, which is a statement about Reddit rather than about this connection.

Ask the agent to diagnose it:

List the Reddit Ads tools you actually have available and tell me whether you also have any organic Reddit tools. Then use the exact name for what I asked.

Try reconnecting Reddit Ads and complete the consent flow in the same browser session. Partial OAuth approvals or switching accounts mid-flow can leave the connection incomplete.

Yes. ClawLink is the fastest way to connect Hermes to Reddit Ads: link your Reddit Ads account once in the browser and Hermes Agent can call the Reddit Ads API through 83 ready-made tools — no custom code or token handling.

Install the plugin with hermes plugins install ClawLink-HQ/hermes-plugin --enable, then pair once: run hermes clawlink begin, approve the link in your browser, and run hermes clawlink finish. Connect Reddit Ads in the dashboard and Hermes can use it from the next message — no config files or API keys to manage.

About two minutes. Sign in, click Connect next to Reddit Ads in the dashboard, authenticate, and Hermes Agent can use it from the next chat message.

The alternative to ClawLink is usually manual OAuth app setup plus your own token handling, permission troubleshooting, and tool plumbing for Hermes Agent. That is fine if you want to build and maintain the integration yourself. Most teams just want Reddit Ads working from chat.

No. Registering an app at reddit.com/prefs/apps, holding its client id and secret, and implementing the authorization-code exchange is what you do when you build the integration yourself. Here you sign in to Reddit, approve the access, and the connection exists. The part that is not removed, and cannot be, is Reddit's own permission model: the account you connect must have access to the ad account you want to work with. An app cannot grant you that, and neither can we.

Your Reddit account needs to be associated with the ad account, which in Reddit's business hierarchy means being a member of the business that owns it with a role that permits reading or managing ads. If you run the ads yourself from your own account, you already have this. If someone else set the account up, they add you from Reddit Ads under the business's member settings. The symptom of missing access is specific and worth recognizing: the connection succeeds, and then reddit_ads_list_ad_accounts_by_business comes back empty. That is an access gap, not a broken integration.

It can create and modify campaigns, ad groups, and ads, which means it can create things that spend. Treat that as a workflow decision rather than a technical one. Campaign creation here takes several deliberate calls, so nothing launches from a single vague instruction, and the safe pattern is to have the agent create campaigns paused and to review before anything goes live. If you only want analysis, say so and keep the agent on the reporting tools such as reddit_ads_get_a_report and reddit_ads_list_campaigns, which read without changing anything.

The mechanics worth checking are these, and they are more useful than a yes or no. The connection is an OAuth grant that Reddit lists in your account's authorized applications, so revoking it is a click on Reddit's side and does not depend on us. The agent's reach is the named tools on this page rather than an open API session, and the ones that create or modify are individually named, including reddit_ads_create_campaign, reddit_ads_create_ad_group, and reddit_ads_update_campaign. Your Reddit role still bounds everything: an account with read-only access to the business cannot be talked into spending. The risk that no connection model removes is the agent acting on bad input, which is why creating paused and reviewing before launch is the pattern worth keeping.

Pairing is a two-step handshake: run hermes clawlink begin, approve the link in your browser, then run hermes clawlink finish. If you ran finish before approving, or the approval link expired, run hermes clawlink begin again to get a fresh link. Confirm the plugin was installed with --enable, then verify with hermes clawlink test.