---
title: "Submit saved signup form by company"
method: POST
path: "/forms/{companyIdOrFormId}/{formId}"
tags: ["Widgets"]
---

# Submit saved signup form by company

`POST /forms/{companyIdOrFormId}/{formId}`

Compatibility path for saved signup form submissions. New embeds should use `/forms/{formId}`.

The form's stored settings are the source of truth for audience targeting (lists, tags) and success behavior (success message or redirect URL), so dashboard edits apply to deployed embeds without re-embedding. List, tag, and redirect values in the request are ignored.

## Path parameters

- `companyIdOrFormId` string, required
- `formId` string, required

## Request body

- object
  - `email` string, email, required — Subscriber email address
  - `firstName` string
  - `lastName` string
  - `phone` string — Subscriber phone number in E.164 or US national format, when configured on the saved form. Stored on the base subscriber profile and does not grant SMS consent.
  - `customAttributes` object — Subscriber custom attributes for custom fields configured on the saved form
  - `listIds` string[] — Ignored for saved forms. Stored form settings are used.
  - `listIds[]` string[] — Ignored for saved forms. Stored form settings are used.
  - `tagIds` string[] — Ignored for saved forms. Stored form settings are used.
  - `tagIds[]` string[] — Ignored for saved forms. Stored form settings are used.
  - `duplicateStrategy` 'skip' | 'merge' | 'overwrite' — Ignored for saved forms. Stored form settings are used.
  - `duplicateStrategyToken` string — Ignored for saved forms. Stored form settings are used.
  - `redirectUrl` string — Ignored for saved forms. Stored form settings are used.
  - `website` string — Honeypot field. Leave empty.

## Response `200`

Form submitted successfully. Native HTML form posts that accept `text/html` receive a hosted confirmation page showing the form's success message instead of JSON.

- object
  - `success` boolean

## Other responses

- `303` — Redirect after successful form submission, using the redirect URL stored in the form's settings
- `400` — Invalid email or blocked address
- `404` — Form not found for this company
- `429` — Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.net/sequenzy/apis/sequenzy-api.md) · [All operations](https://skmtc.net/sequenzy/apis/sequenzy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sequenzy/sequenzy-api/versions/af1cf9620482/schema)