OMomnisend
Forms

Get form

Get a single form by ID, including its content, styling, targeting rules, and status. When the form is part of an A/B test, abSetupID and abStatus identify the setup it belongs to.

Scopes: forms.read

Rate Limiting: This endpoint is rate limited to 400 requests per minute.

get/forms/{formID}

Request

  • Base URL
    https://api.omnisend.com/api
  • URL
    https://api.omnisend.com/api/forms/{formID}
  • Auth
    • OAuth 2
      Client credentials
      Token URL: https://app.omnisend.com/oauth2/token scopes: forms.read
    • or API key in header Authorization

Path parameters

formIDstring required

Form ID

Headers

Omnisend-Versionstring required

API version that specifies the response format and behaviour

Response

Form

abSetupIDstring

A/B setup unique identifier the form belongs to (read-only)

abStatus'enabled' | 'draft' | 'disabled'

A/B test status of a form. disabled is a launched A/B test that is currently paused.

contactTagsstring[]

Tags applied to contacts who submit the form

createdAtstring

Form creation timestamp (read-only)

disabledAtstring

Form disable timestamp (read-only)

displayType'popup' | 'landingPage' | 'embedded' | 'flyout' | 'fullscreen'

Form display type, controlling how the form is presented to visitors. popup is a modal centered over the page (highest visibility, best for offers and exit-intent); flyout is a compact panel anchored to a corner (non-intrusive, always-on signup); embedded renders inline within the host page's content (permanent signup block); landingPage is a full standalone page hosted by Omnisend (ad or link driven campaigns); fullscreen is a modal that covers the whole viewport (maximum attention, no surrounding page visible).

enabledAtstring

Form enable timestamp (read-only)

idstring

Form unique identifier (read-only)

launchedAtstring

Form launch timestamp (read-only)

namestring

Form name

status'enabled' | 'disabled' | 'draft'

Form status.

updatedAtstring

Form last update timestamp (read-only)

Changes

No recorded changes to this operation across all 1 revision of this API.