Activepieces installs custom pieces straight from npm by package name. Hermoso publishes its piece as @hermoso/piece-hermoso: eight actions (Generate Image, Generate Video, Get Render Job, Create Post, List Library Items, Search Meta Ads, Research Ads and a Custom API Call) and a New Library Item trigger. It signs in with a Hermoso API key.
Before you start
- A platform admin on an Activepieces platform that accepts custom pieces, such as a self-hosted instance. You install the piece once for the platform, and everyone on it can then use it.
- A Hermoso account. The free plan is enough to try it (see pricing). No account yet? Create one in the app first.
The steps
- Sign in to Activepieces as a platform admin and open Platform Admin, then Pieces. Activepieces' docs list it under Catalogue.
- Click Install Piece and leave Package Type on NPM Registry.
- For Piece Name enter
@hermoso/piece-hermoso. For Piece Version enter the latest version shown on npm. Click Install. - In Hermoso, open the MCP & CLI tab and create a key under Terminal & API keys. Copy it.
- In a flow, add a step and search for Hermoso. Create a new connection, paste the key and save. Activepieces checks the key with Hermoso before it saves the connection.
- Pick the Brand the step works on. The list comes from your Hermoso account.
Prefer the API? A platform admin can install it with one call:
curl -X POST "$AP_URL/api/v1/pieces" \
-H "Authorization: Bearer $AP_TOKEN" -H "Content-Type: application/json" \
-d '{"packageType":"REGISTRY","scope":"PLATFORM","pieceName":"@hermoso/piece-hermoso","pieceVersion":"<latest version>"}'
Hermoso is not in Activepieces' built-in catalog, so this install is the route on any platform that accepts custom pieces. The source is public at github.com/hermoso-ai/activepieces-piece-hermoso.
What the key lets it do
The key lets Activepieces act as your Hermoso account: research ads, plan and make creative, and use your credits for paid actions. You can revoke it at any time in Hermoso, on the MCP & CLI tab under Terminal & API keys.
Connecting Hermoso does not connect your ad accounts or social channels. You add those inside Hermoso, under Workspace, Connectors, and only the ones you want. Ads are created paused, and nothing is posted or spent unless you ask for it.
A flow to try
Trigger: a new product in your store. Action 1: Hermoso, Generate Image, with a prompt built from the product name. Action 2: Hermoso, Create Post, with the image from step 1 and a caption, in the next free slot of your posting queue.
Want more like that? The workflows are ready prompts for whole marketing jobs: competitor research into ads, ads from customer reviews, a week of scheduled posts, a paused Meta campaign.
Related
- Everything the Hermoso MCP server does
- Use Hermoso with ChatGPT dots
- Connect Hermoso to Lovable
- Connect Hermoso to Replit
- Connect Hermoso to Bolt
- Every host you can connect by URL
These steps follow Activepieces: Community (Public NPM) and Activepieces: Pieces, read on 2026-11-19. Menus move, so if a name here no longer matches what you see, that page is the authority. Hermoso is not affiliated with or endorsed by the makers of Activepieces.
Connected? The workflows are ready prompts for whole marketing jobs. Pick one and run it.
See the workflows → Or start in the app

