Forms

Delete form

Delete a single form by ID. Forms can be deleted in any state (draft, enabled, disabled). Deleting a non-existent form succeeds (idempotent).

When the form owns an A/B test setup, the setup and its version forms are deleted as well. A/B test version forms cannot be deleted directly; delete the parent form's A/B setup instead.

Scopes: forms.write

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

delete/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.write
    • 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 deleted

Changes

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