HTML Pages API

GET /pages/api/page

List every page in your workspace. Returns an array of page objects. Use this to find a page's pageId before updating it.

Example

curl https://api.app.customjs.io/pages/api/page \
  -H "x-api-key: YOUR_API_KEY"

Response

[
  {
    "pageId": "pg_8f21",
    "name": "Launch page",
    "htmlFileUrl": "https://pages.customjs.io/launch-page.html"
  }
]

POST /pages/page/upload-html

Create a new hosted page. The response contains the live htmlFileUrl.

Request body

Example

curl -X POST https://api.app.customjs.io/pages/page/upload-html \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Launch page",
    "htmlContent": "<h1>Launch day</h1>"
  }'

Response

{
  "pageId": "pg_8f21",
  "htmlFileUrl": "https://pages.customjs.io/launch-page.html",
  "name": "Launch page",
  "message": "Page created",
  "created": true
}

PUT /pages/api/page/id/{pageId}/update-html

Replace the HTML of an existing page. The live URL stays the same, so the page updates in place.

Request body

The pageId comes from the create response or the list endpoint.

Example

curl -X PUT https://api.app.customjs.io/pages/api/page/id/pg_8f21/update-html \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Launch page",
    "htmlContent": "<h1>Launch day v2</h1>"
  }'

Response

{
  "pageId": "pg_8f21",
  "htmlFileUrl": "https://pages.customjs.io/launch-page.html",
  "name": "Launch page",
  "message": "Page updated"
}

Upsert pattern

To publish idempotently, list the pages, match by name, then update or create. This is exactly what the Make module and n8n node do.

// Create the first time, update on every run after
const pages = await api.get('/pages/api/page');
const existing = pages.find(p => p.name === name);

if (existing) {
  await api.put('/pages/api/page/id/' + existing.pageId + '/update-html', { name, htmlContent });
} else {
  await api.post('/pages/page/upload-html', { name, htmlContent });
}

Response object