Forms

Retrieve a signup form

Retrieve a signup form by ID.

get/v1/forms/{id}

Request

  • Base URL: https://smtpfa.st/api
  • URL: https://smtpfa.st/api/v1/forms/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

The signup form ID

Response

Form details

objectstring required
idstring required
namestring required
fieldsstring[] required
button_textstring required
button_colorstring required
success_messagestring required
double_opt_inboolean required
redirect_urlstring nullable
captcha_enabledboolean required
captcha_provider'turnstile' required
turnstile_site_keystring nullable
turnstile_secret_configuredboolean required
block_disposable_emailsboolean required
activeboolean required
confirmation_email_fromstring nullable

Sender of the double opt-in confirmation email. Create, retrieve and update return it; list items leave it out.

welcome_email_enabledboolean

Create, retrieve and update return it; list items leave it out.

welcome_email_fromstring nullable

Create, retrieve and update return it; list items leave it out.

welcome_email_subjectstring nullable

Create, retrieve and update return it; list items leave it out.

welcome_email_markdownstring nullable

Create, retrieve and update return it; list items leave it out.

pending_confirmations_countinteger

Signups waiting on their confirmation click. List items leave it out.

created_atstring date-time required
updated_atstring date-time required

Example response

{
  "object": "signup_form",
  "id": "clx_form123",
  "name": "Newsletter signup",
  "fields": [
    "email",
    "first_name"
  ],
  "button_text": "Subscribe",
  "button_color": "#10b981",
  "success_message": "Thanks for subscribing!",
  "double_opt_in": true,
  "captcha_provider": "turnstile",
  "block_disposable_emails": true,
  "active": true,
  "confirmation_email_from": "Acme <hello@acme.com>"
}

Changes

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