forms

Embed

<a href="https://hermetica.15.204.158.166.sslip.io/docs/ref-forms"><img src="https://hermetica.15.204.158.166.sslip.io/docs/_api/public/orgs/5fcd8b3c-a27c-4688-972f-de710125592f/spaces/caf5dc05-15f7-4e0c-bdb8-ab29ede6211e/pages/3a095c68-d07c-4776-8a75-070cf1437150/social-card.svg?v=3e7ae33eec8b" alt="forms" width="600" height="315"></a>

GEThttps://hermetica.15.204.158.166.sslip.io/v1/forms

Filter by name, status, kind, ad id and created/updated ranges; sort by created, updated or name

Parameters

limitintegerquery

= 50

cursorstringquery

namestringquery

createdFromstringquery

createdTostringquery

updatedFromstringquery

updatedTostringquery

sortstringquery

statusstringquery

draft | published | archived

kindstringquery

embed | popup | flyout | full_page | preference_center

ad_idstringquery

Code samples

cURL

curl -X GET "https://hermetica.15.204.158.166.sslip.io/v1/forms" \
  -H "Authorization: Bearer $SSLIP_API_KEY"

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Example

{
  "items": [
    {
      "id": "string",
      "name": "string",
      "kind": "embed",
      "status": "draft"
    }
  ],
  "nextCursor": "string"
}

Schema

itemsobject[]required

Show child parameters

idstringrequired

namestringrequired

kindstringrequired

embed | popup | flyout | full_page | preference_center

statusstringrequired

draft | published | archived

nextCursorstringrequired

4XX Default Response

Example

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

Schema

errorobjectrequired

Show child parameters

codestringrequired

messagestringrequired

detailsobject

5XX Default Response

Same as 4XX · GET /v1/forms

POSThttps://hermetica.15.204.158.166.sslip.io/v1/forms

Request body

application/json

namestringrequired

kindstring

embed | popup | flyout | full_page | preference_center = full_page

definitionobjectrequired

Show child parameters

captchaobject

Show child parameters

providerstringrequired

turnstile | hcaptcha | recaptcha | friendlycaptcha

siteKeystringrequired

actionsobject[]

= []

redirectsobject

Show child parameters

alreadySubscribedstring

errorstring

pendingstring

confirmedstring

progressivestring

off | hide | prefill = off

kioskboolean

= false

themeobject

Show child parameters

primarystring

= #1f6feb

backgroundstring

= #ffffff

textstring

= #111111

fontstring

system | serif | mono = system

radiusinteger

= 8

buttonStylestring

solid | outline = solid

logoUrlstring

teaserobject

Show child parameters

textstringrequired

sidestring

left | right | bottom = right

countdownobject

Show child parameters

tostringrequired

labelstring

expiredTextstring

spinobject

Show child parameters

segmentsobject[]required

stepsobject[]required

Show child parameters

titlestring

fieldsobject[]required

successobject

= {"type":"message","text":"Thanks!"}

doubleOptInobject

Show child parameters

connectionIdstringrequired

subjectstring

= Please confirm your subscription

ttlHoursinteger

= 72

bodystring

templateIdstring

topicIdstring

tagsstring[]

= []

listIdsstring[]

= []

progressiveLimitinteger

submissionLimitobject

Show child parameters

maxintegerrequired

messagestring

= This form is no longer accepting responses.

maxPerIpPerDayinteger

maxPerVisitorPerDayinteger

localestring

minFillMsinteger

= 1500

welcomeEmailobject

Show child parameters

connectionIdstringrequired

subjectstringrequired

textstringrequired

alreadySubscribedEmailobject

Show child parameters

connectionIdstringrequired

subjectstringrequired

textstringrequired

blockFreeEmailboolean

= false

submitLabelstring

failureTextstring

targetingobject

= {}

Show child parameters

urlIncludestring[]

urlExcludestring[]

delaySecondsnumber

scrollPercentnumber

exitIntentboolean

mobileBackExitboolean

inactivitySecondsnumber

devicestring

all | desktop | mobile

visitorstring

all | new | returning

minPageViewsinteger

frequencyDaysnumber

audienceobject

Show child parameters

modestring

show | hide = show

listIdsstring[]

= []

segmentIdsstring[]

= []

hideKnownSubscribersboolean

countriesstring[]

countriesExcludestring[]

utmobject

Show child parameters

sourcestring

mediumstring

campaignstring

referrerIncludestring[]

cartobject

Show child parameters

minValuenumber

minItemsinteger

emptyboolean

productPagestring

only | never

adIdstring

{
  "name": "string",
  "kind": "full_page",
  "definition": {
    "captcha": {
      "provider": "turnstile",
      "siteKey": "string"
    },
    "actions": [],
    "redirects": {
      "alreadySubscribed": "string",
      "error": "string",
      "pending": "string",
      "confirmed": "string"
    },
    "progressive": "off",
    "kiosk": false,
    "theme": {
      "primary": "#1f6feb",
      "background": "#ffffff",
      "text": "#111111",
      "font": "system",
      "radius": 8,
      "buttonStyle": "solid",
      "logoUrl": "string"
    },
    "teaser": {
      "text": "string",
      "side": "right"
    },
    "countdown": {
      "to": "2024-01-01T00:00:00Z",
      "label": "",
      "expiredText": ""
    },
    "spin": {
      "segments": [
        {
          "label": "string",
          "weight": 0,
          "poolId": "string"
        }
      ]
    },
    "steps": [
      {
        "title": "string",
        "fields": [
          {
            "type": "email",
            "key": "string",
            "label": "",
            "required": false,
            "when": [
              {
                "field": "string",
                "op": "eq",
                "value": ""
              }
            ],
            "placeholder": "string",
            "helpText": "string",
            "className": "string",
            "saveTo": "string",
            "attributes": {},
            "pattern": "string",
            "validationMessage": "string",
            "requiredMessage": "string",
            "minLength": 0,
            "maxLength": 0,
            "always": true,
            "readOnly": true,
            "group": "string",
            "groupCollapsed": true
          }
        ]
      }
    ],
    "success": {
      "type": "message",
      "text": "Thanks!"
    },
    "doubleOptIn": {
      "connectionId": "string",
      "subject": "Please confirm your subscription",
      "ttlHours": 72,
      "body": "string",
      "templateId": "string"
    },
    "topicId": "string",
    "tags": [],
    "listIds": [],
    "progressiveLimit": 0,
    "submissionLimit": {
      "max": 0,
      "message": "This form is no longer accepting responses."
    },
    "maxPerIpPerDay": 0,
    "maxPerVisitorPerDay": 0,
    "locale": "string",
    "minFillMs": 1500,
    "welcomeEmail": {
      "connectionId": "string",
      "subject": "string",
      "text": "string"
    },
    "alreadySubscribedEmail": {
      "connectionId": "string",
      "subject": "string",
      "text": "string"
    },
    "blockFreeEmail": false,
    "submitLabel": "string",
    "failureText": "string"
  },
  "targeting": {},
  "adId": "string"
}

Code samples

cURL

curl -X POST "https://hermetica.15.204.158.166.sslip.io/v1/forms" \
  -H "Authorization: Bearer $SSLIP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"string","kind":"full_page","definition":{"captcha":{"provider":"turnstile","siteKey":"string"},"actions":[],"redirects":{"alreadySubscribed":"string","error":"string","pending":"string","confirmed":"string"},"progressive":"off","kiosk":false,"theme":{"primary":"#1f6feb","background":"#ffffff","text":"#111111","font":"system","radius":8,"buttonStyle":"solid","logoUrl":"string"},"teaser":{"text":"string","side":"right"},"countdown":{"to":"2024-01-01T00:00:00Z","label":"","expiredText":""},"spin":{"segments":[{"label":"string","weight":0,"poolId":"string"}]},"steps":[{"title":"string","fields":[{"type":"email","key":"string","label":"","required":false,"when":[{"field":"string","op":"eq","value":""}],"placeholder":"string","helpText":"string","className":"string","saveTo":"string","attributes":{},"pattern":"string","validationMessage":"string","requiredMessage":"string","minLength":0,"maxLength":0,"always":true,"readOnly":true,"group":"string","groupCollapsed":true}]}],"success":{"type":"message","text":"Thanks!"},"doubleOptIn":{"connectionId":"string","subject":"Please confirm your subscription","ttlHours":72,"body":"string","templateId":"string"},"topicId":"string","tags":[],"listIds":[],"progressiveLimit":0,"submissionLimit":{"max":0,"message":"This form is no longer accepting responses."},"maxPerIpPerDay":0,"maxPerVisitorPerDay":0,"locale":"string","minFillMs":1500,"welcomeEmail":{"connectionId":"string","subject":"string","text":"string"},"alreadySubscribedEmail":{"connectionId":"string","subject":"string","text":"string"},"blockFreeEmail":false,"submitLabel":"string","failureText":"string"},"targeting":{},"adId":"string"}'

TypeScript

Python

PHP

Ruby

Java

Responses

201 Default Response

Example

{
  "id": "string",
  "name": "string",
  "kind": "embed",
  "status": "draft"
}

Schema

idstringrequired

namestringrequired

kindstringrequired

embed | popup | flyout | full_page | preference_center

statusstringrequired

draft | published | archived

4XX Default Response

Same as 4XX · GET /v1/forms

5XX Default Response

Same as 4XX · GET /v1/forms

GEThttps://hermetica.15.204.158.166.sslip.io/v1/forms/{id}

Parameters

idstringpathrequired

Code samples

cURL

curl -X GET "https://hermetica.15.204.158.166.sslip.io/v1/forms/{id}" \
  -H "Authorization: Bearer $SSLIP_API_KEY"

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Same as 201 · POST /v1/forms

4XX Default Response

Same as 4XX · GET /v1/forms

5XX Default Response

Same as 4XX · GET /v1/forms

Next part

Updated Nov 3, 2026

Was this page helpful?