Blocks

A Hopla page is an ordered list of blocks (blocks): links, section headings, text, videos, products… The API returns them in display order, each with its id.

TypesCopy Anchor Link

linkheadingtextvideolatest-videoemail-signupproofproducttipbookingmusicfaqcontact-cardlocationgallerycontact-formfeed

Without type, a new block is a link (link). The type is immutable after creation: to change it, delete the block and create a new one.

FieldsCopy Anchor Link

The API reference documents every field, including read-only ones.

Create a blockCopy Anchor Link

POST /blocks inserts the block at the top of the page, or at index position (0 = top).

curl -X POST https://app.hopla.page/api/v2/blocks \
  -H "Authorization: Bearer $HOPLA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type": "heading", "title": "Mes formations", "position": 3}'

Common block examples:

{
  "title": "Réserver une séance",
  "url": "https://cal.com/camille/seance",
  "featured": true,
  "format": "card",
  "description": "45 minutes, en visio ou à Lyon."
}

Update, hide or schedule a blockCopy Anchor Link

PATCH /blocks/{id} updates only the fields sent; other fields are unchanged.

curl -X PATCH https://app.hopla.page/api/v2/blocks/a1b2c3d4e5f6 \
  -H "Authorization: Bearer $HOPLA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"visible": false}'

curl -X PATCH https://app.hopla.page/api/v2/blocks/a1b2c3d4e5f6 \
  -H "Authorization: Bearer $HOPLA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"startsAt": "2026-12-01T09:00:00+01:00", "endsAt": "2026-12-15T23:59:00+01:00", "countdown": true}'

To clear a date, send an empty string: {"endsAt": ""}.

Duplicate a blockCopy Anchor Link

POST /blocks/{id}/duplicate inserts a copy right below the block, with a new id. With {"hidden": true}, the copy is hidden, so you can edit it before publishing.

curl -X POST https://app.hopla.page/api/v2/blocks/a1b2c3d4e5f6/duplicate \
  -H "Authorization: Bearer $HOPLA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hidden": true}'

Images in a blockCopy Anchor Link

image (link thumbnail, product photo) and images (gallery) expect the path of an image hosted by Hopla. Upload it first with POST /media, then use the returned path in the block.

Reorder blocksCopy Anchor Link

PUT /blocks/order expects the id of every block, each exactly once, top to bottom. If an id is missing, duplicated or does not belong to the page, the API returns 400 invalid_order and changes nothing.

curl -X PUT https://app.hopla.page/api/v2/blocks/order \
  -H "Authorization: Bearer $HOPLA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ids": ["f6e5d4c3b2a1", "a1b2c3d4e5f6", "0a1b2c3d4e5f"]}'

Delete a blockCopy Anchor Link

DELETE /blocks/{id} permanently deletes the block. To hide it temporarily, use {"visible": false}.

Plan restrictionsCopy Anchor Link

Blocks go through the same validation as in the admin panel. When the plan changes, no data is deleted: features not included in the new plan are kept and reactivated when the account upgrades again.