landing-pages

Embed

<a href="https://hermeticor.com/docs/ref-landing-pages"><img src="https://hermeticor.com/docs/_api/public/orgs/5fcd8b3c-a27c-4688-972f-de710125592f/spaces/caf5dc05-15f7-4e0c-bdb8-ab29ede6211e/pages/c6be5417-6c86-4c1d-96eb-b62b10fbdcb8/social-card.svg?v=3e7ae33eec8b" alt="landing-pages" width="600" height="315"></a>

PUThttps://hermeticor.com/v1/landing-pages/{id}/languages/primary

Make this page the group fallback (served at its address by Accept-Language)

Parameters

idstringpathrequired

Code samples

cURL

curl -X PUT "https://hermeticor.com/v1/landing-pages/{id}/languages/primary" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY"

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Example

{
  "id": "string",
  "name": "string",
  "slug": "string",
  "status": "draft",
  "publishedAt": "2024-01-01T00:00:00Z"
}

Schema

idstringrequired

namestringrequired

slugstringrequired

statusstringrequired

draft | published

publishedAtstringrequired

4XX Default Response

Example

{
  "error": {
    "code": "string",
    "message": "string",
    "details": {}
  }
}

Schema

errorobjectrequired

Show child parameters

codestringrequired

messagestringrequired

detailsobject

5XX Default Response

Same as 4XX · PUT /v1/landing-pages/{id}/languages/primary

PUThttps://hermeticor.com/v1/landing-page-languages

Re-label locales of pages in one group

Request body

application/json

languagesobject[]required

Show child parameters

pageIdstringrequired

localestringrequired

{
  "languages": [
    {
      "pageId": "string",
      "locale": "string"
    }
  ]
}

Code samples

cURL

curl -X PUT "https://hermeticor.com/v1/landing-page-languages" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"languages":[{"pageId":"string","locale":"string"}]}'

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Example

{
  "items": [
    {
      "id": "string",
      "name": "string",
      "slug": "string",
      "status": "draft",
      "publishedAt": "2024-01-01T00:00:00Z"
    }
  ]
}

Schema

itemsItemsItem75[]required

Show child parameters

idstringrequired

namestringrequired

slugstringrequired

statusstringrequired

draft | published

publishedAtstringrequired

4XX Default Response

Same as 4XX · PUT /v1/landing-pages/{id}/languages/primary

5XX Default Response

Same as 4XX · PUT /v1/landing-pages/{id}/languages/primary

POSThttps://hermeticor.com/v1/landing-pages/{id}/ab/variants

Add a copy as a new arm (even split); publish it to start serving

Parameters

idstringpathrequired

Code samples

cURL

curl -X POST "https://hermeticor.com/v1/landing-pages/{id}/ab/variants" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY"

TypeScript

Python

PHP

Ruby

Java

Responses

201 Default Response

Same as 200 · PUT /v1/landing-pages/{id}/languages/primary

4XX Default Response

Same as 4XX · PUT /v1/landing-pages/{id}/languages/primary

5XX Default Response

Same as 4XX · PUT /v1/landing-pages/{id}/languages/primary

PUThttps://hermeticor.com/v1/landing-pages/{id}/ab/weights

Traffic split per arm (control included)

Parameters

idstringpathrequired

Request body

application/json

weightsobject[]required

Show child parameters

pageIdstringrequired

weightintegerrequired

{
  "weights": [
    {
      "pageId": "string",
      "weight": 0
    }
  ]
}

Code samples

cURL

curl -X PUT "https://hermeticor.com/v1/landing-pages/{id}/ab/weights" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"weights":[{"pageId":"string","weight":0}]}'

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Same as 200 · PUT /v1/landing-pages/{id}/languages/primary

4XX Default Response

Same as 4XX · PUT /v1/landing-pages/{id}/languages/primary

5XX Default Response

Same as 4XX · PUT /v1/landing-pages/{id}/languages/primary

GEThttps://hermeticor.com/v1/landing-pages/{id}/ab

Parameters

idstringpathrequired

Code samples

cURL

curl -X GET "https://hermeticor.com/v1/landing-pages/{id}/ab" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY"

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Example

{
  "status": "none",
  "winnerId": "string",
  "arms": [
    {
      "pageId": "string",
      "slug": "string",
      "weight": 0,
      "visits": 0,
      "signups": 0,
      "conversion": 0
    }
  ]
}

Schema

statusstringrequired

none | running | ended

winnerIdstringrequired

armsobject[]required

Show child parameters

pageIdstringrequired

slugstringrequired

weightintegerrequired

visitsintegerrequired

signupsintegerrequired

conversionnumberrequired

4XX Default Response

Same as 4XX · PUT /v1/landing-pages/{id}/languages/primary

5XX Default Response

Same as 4XX · PUT /v1/landing-pages/{id}/languages/primary

POSThttps://hermeticor.com/v1/landing-pages/{id}/ab/end

Send all traffic to the winner (best conversion when none is given)

Parameters

idstringpathrequired

Request body

application/json

winnerIdstring

{
  "winnerId": "string"
}

Code samples

cURL

curl -X POST "https://hermeticor.com/v1/landing-pages/{id}/ab/end" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"winnerId":"string"}'

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Same as 200 · PUT /v1/landing-pages/{id}/languages/primary

4XX Default Response

Same as 4XX · PUT /v1/landing-pages/{id}/languages/primary

5XX Default Response

Same as 4XX · PUT /v1/landing-pages/{id}/languages/primary

POSThttps://hermeticor.com/v1/landing-pages/{id}/ab/rerun

Parameters

idstringpathrequired

Code samples

cURL

curl -X POST "https://hermeticor.com/v1/landing-pages/{id}/ab/rerun" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY"

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Same as 200 · PUT /v1/landing-pages/{id}/languages/primary

4XX Default Response

Same as 4XX · PUT /v1/landing-pages/{id}/languages/primary

5XX Default Response

Same as 4XX · PUT /v1/landing-pages/{id}/languages/primary

POSThttps://hermeticor.com/p/l/{ref}/click

Beacon from a hosted page: one link was clicked

Parameters

pstringquery

refstringpathrequired

Request body

application/json

urlstringrequired

{
  "url": "string"
}

Code samples

cURL

curl -X POST "https://hermeticor.com/p/l/{ref}/click" \
  -H "Content-Type: application/json" \
  -d '{"url":"string"}'

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Example

{
  "ok": true
}

Schema

okbooleanrequired

true

4XX Default Response

Same as 4XX · PUT /v1/landing-pages/{id}/languages/primary

5XX Default Response

Same as 4XX · PUT /v1/landing-pages/{id}/languages/primary

GEThttps://hermeticor.com/p/l/{ref}/companies

Company suggestions for the form on a hosted page

Parameters

qstringqueryrequired

limitintegerquery

Page size; omitted returns the whole list

cursorstringquery

Opaque: the nextCursor of the previous page

refstringpathrequired

Code samples

cURL

curl -X GET "https://hermeticor.com/p/l/{ref}/companies?q=<q>"

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Example

{
  "items": [
    "string"
  ],
  "nextCursor": "string"
}

Schema

itemsstring[]required

nextCursorstringrequired

4XX Default Response

Same as 4XX · PUT /v1/landing-pages/{id}/languages/primary

5XX Default Response

Same as 4XX · PUT /v1/landing-pages/{id}/languages/primary

Next part

Updated Nov 8, 2026

Was this page helpful?