List Saved Forms - Sequenzy

GET

api

forms

List Saved Forms

curl --request GET \
  --url https://api.sequenzy.com/api/v1/forms \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.sequenzy.com/api/v1/forms', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sequenzy.com/api/v1/forms",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sequenzy.com/api/v1/forms"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.sequenzy.com/api/v1/forms")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "companyId": "company_123",
  "forms": [
    {
      "id": "form_123",
      "name": "Blog newsletter",
      "status": "published",
      "settings": {
        "duplicateStrategy": "skip",
        "resubscribeBehavior": "reactivate",
        "listMode": "specific",
        "listIds": [
          "list_123"
        ],
        "tagIds": [],
        "templateId": "editorial-split",
        "themeMode": "design-system",
        "formStyle": "button-below",
        "buttonText": "Subscribe",
        "buttonColor": null,
        "placeholderEmail": "you@example.com",
        "eyebrowText": "",
        "headline": "",
        "description": "",
        "imageUrl": null,
        "imageAlt": "",
        "visualPlacement": "none",
        "overlayColor": null,
        "overlayOpacity": 0.35,
        "fontFamily": null,
        "fontSize": null,
        "fontColor": null,
        "borderRadius": null,
        "afterSubmission": "message",
        "redirectUrl": "",
        "successMessage": "Thanks for subscribing!",
        "successFontColor": null,
        "successFontSize": "14",
        "errorMessage": "Something went wrong. Please try again.",
        "showFirstName": false,
        "showLastName": false,
        "placeholderFirstName": "First name",
        "placeholderLastName": "Last name",
        "firstNameRequired": false,
        "lastNameRequired": false,
        "fieldOrder": [],
        "customFields": []
      },
      "actionUrl": "https://api.sequenzy.com/api/v1/forms/form_123",
      "content": {
        "version": 1,
        "surface": "form",
        "template": "editorial-split",
        "theme": {
          "accentColor": "#0f766e",
          "backgroundColor": "#ffffff",
          "textColor": "#111827",
          "mutedTextColor": "#6b7280",
          "cardColor": "#ffffff",
          "borderColor": "#e5e7eb",
          "borderRadius": 8,
          "headingFontFamily": "",
          "bodyFontFamily": "",
          "density": "balanced"
        },
        "settings": {
          "duplicateStrategy": "skip",
          "resubscribeBehavior": "reactivate",
          "listMode": "specific",
          "listIds": [
            "list_123"
          ],
          "tagIds": [],
          "afterSubmission": "message",
          "redirectUrl": ""
        },
        "blocks": [
          {
            "id": "email",
            "kind": "form-field",
            "fieldType": "email",
            "label": "",
            "showLabel": true,
            "name": "email",
            "placeholder": "",
            "required": true,
            "defaultValue": "",
            "options": [],
            "mapsTo": "email",
            "consentText": ""
          },
          {
            "id": "submit",
            "kind": "submit-button",
            "text": "Subscribe"
          }
        ]
      },
      "submissionCount": 42,
      "publishedAt": "2026-09-01T10:00:00Z",
      "createdAt": "2026-09-01T10:00:00Z",
      "updatedAt": "2026-09-01T10:00:00Z",
      "url": "https://sequenzy.com/dashboard/company/company_123/forms/form_123"
    }
  ],
  "url": "https://sequenzy.com/dashboard/company/company_123/forms"
}

{
  "error": "Missing API key. Provide via x-api-key header or Authorization: Bearer <key>"
}

{ "error": "API key is missing required scope: widgets:read" }

List the saved forms that belong to your selected workspace. Each result includes its server-managed audience settings and client-safe public action.

curl "https://api.sequenzy.com/api/v1/forms" \
  -H "Authorization: Bearer YOUR_API_KEY"

Form data

Each form includes:

settings: audience targeting, duplicate handling and success behavior.
content: the complete builder document with version: 1, surface: "form", template, theme, settings and blocks. Read content.blocks before replacing blocks.
submissionCount: recorded submissions.
publishedAt: nullable publication timestamp. Unpublishing can preserve it; use status to determine whether the form is currently published.
createdAt and updatedAt: ISO 8601 timestamps.
actionUrl: public submission endpoint.
url: dashboard link to edit this form.

The top-level url opens your forms dashboard. Create and update responses return the same form shape. Create returns embed; update includes it only when the form is published. embed contains actionUrl, scriptUrl, javascript, nativeForm, fetch and supportedPlatforms.

Responses

{
  "success": true,
  "companyId": "company_123",
  "forms": [
    {
      "id": "form_123",
      "name": "Blog newsletter",
      "status": "published",
      "settings": {
        "duplicateStrategy": "skip",
        "resubscribeBehavior": "reactivate",
        "listMode": "specific",
        "listIds": [
          "list_123"
        ],
        "tagIds": [],
        "templateId": "editorial-split",
        "themeMode": "design-system",
        "formStyle": "button-below",
        "buttonText": "Subscribe",
        "buttonColor": null,
        "placeholderEmail": "you@example.com",
        "eyebrowText": "",
        "headline": "",
        "description": "",
        "imageUrl": null,
        "imageAlt": "",
        "visualPlacement": "none",
        "overlayColor": null,
        "overlayOpacity": 0.35,
        "fontFamily": null,
        "fontSize": null,
        "fontColor": null,
        "borderRadius": null,
        "afterSubmission": "message",
        "redirectUrl": "",
        "successMessage": "Thanks for subscribing!",
        "successFontColor": null,
        "successFontSize": "14",
        "errorMessage": "Something went wrong. Please try again.",
        "showFirstName": false,
        "showLastName": false,
        "placeholderFirstName": "First name",
        "placeholderLastName": "Last name",
        "firstNameRequired": false,
        "lastNameRequired": false,
        "fieldOrder": [],
        "customFields": []
      },
      "actionUrl": "https://api.sequenzy.com/api/v1/forms/form_123",
      "content": {
        "version": 1,
        "surface": "form",
        "template": "editorial-split",
        "theme": {
          "accentColor": "#0f766e",
          "backgroundColor": "#ffffff",
          "textColor": "#111827",
          "mutedTextColor": "#6b7280",
          "cardColor": "#ffffff",
          "borderColor": "#e5e7eb",
          "borderRadius": 8,
          "headingFontFamily": "",
          "bodyFontFamily": "",
          "density": "balanced"
        },
        "settings": {
          "duplicateStrategy": "skip",
          "resubscribeBehavior": "reactivate",
          "listMode": "specific",
          "listIds": [
            "list_123"
          ],
          "tagIds": [],
          "afterSubmission": "message",
          "redirectUrl": ""
        },
        "blocks": [
          {
            "id": "email",
            "kind": "form-field",
            "fieldType": "email",
            "label": "",
            "showLabel": true,
            "name": "email",
            "placeholder": "",
            "required": true,
            "defaultValue": "",
            "options": [],
            "mapsTo": "email",
            "consentText": ""
          },
          {
            "id": "submit",
            "kind": "submit-button",
            "text": "Subscribe"
          }
        ]
      },
      "submissionCount": 42,
      "publishedAt": "2026-09-01T10:00:00Z",
      "createdAt": "2026-09-01T10:00:00Z",
      "updatedAt": "2026-09-01T10:00:00Z",
      "url": "https://sequenzy.com/dashboard/company/company_123/forms/form_123"
    }
  ],
  "url": "https://sequenzy.com/dashboard/company/company_123/forms"
}

{
  "error": "Missing API key. Provide via x-api-key header or Authorization: Bearer <key>"
}

{ "error": "API key is missing required scope: widgets:read" }

List Saved Forms

curl --request GET \
  --url https://api.sequenzy.com/api/v1/forms \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.sequenzy.com/api/v1/forms', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sequenzy.com/api/v1/forms",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sequenzy.com/api/v1/forms"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.sequenzy.com/api/v1/forms")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "companyId": "company_123",
  "forms": [
    {
      "id": "form_123",
      "name": "Blog newsletter",
      "status": "published",
      "settings": {
        "duplicateStrategy": "skip",
        "resubscribeBehavior": "reactivate",
        "listMode": "specific",
        "listIds": [
          "list_123"
        ],
        "tagIds": [],
        "templateId": "editorial-split",
        "themeMode": "design-system",
        "formStyle": "button-below",
        "buttonText": "Subscribe",
        "buttonColor": null,
        "placeholderEmail": "you@example.com",
        "eyebrowText": "",
        "headline": "",
        "description": "",
        "imageUrl": null,
        "imageAlt": "",
        "visualPlacement": "none",
        "overlayColor": null,
        "overlayOpacity": 0.35,
        "fontFamily": null,
        "fontSize": null,
        "fontColor": null,
        "borderRadius": null,
        "afterSubmission": "message",
        "redirectUrl": "",
        "successMessage": "Thanks for subscribing!",
        "successFontColor": null,
        "successFontSize": "14",
        "errorMessage": "Something went wrong. Please try again.",
        "showFirstName": false,
        "showLastName": false,
        "placeholderFirstName": "First name",
        "placeholderLastName": "Last name",
        "firstNameRequired": false,
        "lastNameRequired": false,
        "fieldOrder": [],
        "customFields": []
      },
      "actionUrl": "https://api.sequenzy.com/api/v1/forms/form_123",
      "content": {
        "version": 1,
        "surface": "form",
        "template": "editorial-split",
        "theme": {
          "accentColor": "#0f766e",
          "backgroundColor": "#ffffff",
          "textColor": "#111827",
          "mutedTextColor": "#6b7280",
          "cardColor": "#ffffff",
          "borderColor": "#e5e7eb",
          "borderRadius": 8,
          "headingFontFamily": "",
          "bodyFontFamily": "",
          "density": "balanced"
        },
        "settings": {
          "duplicateStrategy": "skip",
          "resubscribeBehavior": "reactivate",
          "listMode": "specific",
          "listIds": [
            "list_123"
          ],
          "tagIds": [],
          "afterSubmission": "message",
          "redirectUrl": ""
        },
        "blocks": [
          {
            "id": "email",
            "kind": "form-field",
            "fieldType": "email",
            "label": "",
            "showLabel": true,
            "name": "email",
            "placeholder": "",
            "required": true,
            "defaultValue": "",
            "options": [],
            "mapsTo": "email",
            "consentText": ""
          },
          {
            "id": "submit",
            "kind": "submit-button",
            "text": "Subscribe"
          }
        ]
      },
      "submissionCount": 42,
      "publishedAt": "2026-09-01T10:00:00Z",
      "createdAt": "2026-09-01T10:00:00Z",
      "updatedAt": "2026-09-01T10:00:00Z",
      "url": "https://sequenzy.com/dashboard/company/company_123/forms/form_123"
    }
  ],
  "url": "https://sequenzy.com/dashboard/company/company_123/forms"
}

{
  "error": "Missing API key. Provide via x-api-key header or Authorization: Bearer <key>"
}

{ "error": "API key is missing required scope: widgets:read" }

​Form data

​Responses

Form data

Responses