Get form settings

Access settings and email notifications of a form.

GET https://cotlet.dev/api/v1/fillout/forms/{form_id}/settings

read

Returns the Access settings of one form (closed, open date, expiration date, submission limit, closed message) and its self-email notifications. Use it before update_form_access or set_email_notifications to see what is set now.

Parameters

Parameters: get_form_settings
NameTypeDescription
form_id string required string Form ID from list_forms.

Request

cURL
curl https://cotlet.dev/api/v1/fillout/forms/form_8c41d2/settings \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("fillout", "get_form_settings", {"form_id":"form_8c41d2"})
Node.js
const result = await cotlet.call('fillout', 'get_form_settings', {"form_id":"form_8c41d2"});
CLI
cotlet call fillout get_form_settings --data '{"form_id":"form_8c41d2"}'

Example response

JSON

{
  "form_id": "tD6wNs3hLz8P",
  "access": {
    "closed": false,
    "open_date": null,
    "expiration_date": "2026-11-15T23:59:00+01:00",
    "submission_limit": null,
    "closed_message": null
  },
  "self_email_notifications": {
    "enabled": true,
    "emails": [
      "events@acme.example"
    ]
  }
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.