Quickstart

Create an API keyCopy Anchor Link

On app.hopla.page, open Réglages (Settings), then API et MCP, and create a key with write access.

The key starts with hopla_ and is shown only once: copy it immediately.

Store the key in an environment variableCopy Anchor Link

Never hardcode the key in source code: store it in an environment variable.

export HOPLA_API_KEY="hopla_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Get the pageCopy Anchor Link

curl https://app.hopla.page/api/v2/page \
  -H "Authorization: Bearer $HOPLA_API_KEY"

The response contains the page URL (url), its plan (plan), its settings (settings) and its blocks (blocks), each with an id.

Add a linkCopy Anchor Link

curl -X POST https://app.hopla.page/api/v2/blocks \
  -H "Authorization: Bearer $HOPLA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Mon nouveau podcast", "url": "https://example.com/podcast"}'

The link is added at the top of the page and is live immediately.