Forms

Update custom messages

put

https://api.typeform.com/forms/{form_id}/messages

Specifies new values for the customizable messages in a form (specified by form_id).

You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

Request

Path Parameters

form_id

, required

Unique ID for the form. Find in your form URL. For example, in the URL "https://mysite.typeform.com/to/u6nXL7" the form_id is u6nXL7.

Request Body

label.buttonHint.default

string

Default tooltip button message. Maximum 28 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.buttonHint.longtext

string

Tooltip button message for long text blocks. Maximum 28 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.warning.connection

string

Server connection error message. Maximum 128 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.buttonNoAnswer.default

string

Default continue button message. Maximum 100 characters.

label.warning.correction

string

List of errors message. Maximum 128 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

block.payment.cardNameTitle

string

Credit card name message. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

block.payment.cardNumberTitle

string

Credit card number message. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

block.payment.cvcDescription

string

Credit card security number message

block.payment.cvcNumberTitle

string

Credit card CVC number message. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

block.shortText.placeholder

string

Text input placeholder. Maximum 100 characters.

label.error.emailAddress

string

Invalid email error message. Maximum 64 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.error.expiryMonthTitle

string

Credit card expiry month message. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.error.expiryYearTitle

string

Credit card expiry year message. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.warning.fallbackAlert

string

Fallback alert message. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

block.fileUpload.choose

string

File upload button message. Maximum 34 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

block.fileUpload.drag

string

File upload dragging action message. Maximum 35 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

block.fileUpload.uploadingProgress

string

Still processing file upload message. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.error.sizeLimit

string

File too big error message. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.warning.formUnavailable

string

Private form error message. Accepts variable form:name. Maximum 128 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.error.incompleteForm

string

Incomplete fields error message. Maximum 42 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.hint.key

string

Key letter hint message. Maximum 100 characters.

block.legal.reject

string

Legal field deny message. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

block.legal.accept

string

Legal field accept message. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.error.maxValue

string

Number maximum value tooltip message. Accepts variable field:max. Maximum 64 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.error.maxLength

string

Text fields maximum length tooltip message. Accepts variable field:max_length. Maximum 64 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.error.minValue

string

Number minimum value tooltip message. Accepts variable field:min. Maximum 64 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.error.range

string

Number minimum and maximum range value tooltip message. Accepts variables field:min and field:max. Maximum 64 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

block.multipleChoice.hint

string

Choose as many as you like message for multiple choice fields. Maximum 45 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.error.mustEnter

string

Required value error message. Maximum 64 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.error.mustSelect

string

Required selection error message. Maximum 64 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.no.shortcut

string

Keyboard shortcut for the "No" option. Maximum 1 character.

label.no.default

string

Representation for the word "No." You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

block.dropdown.hint

string

Not suggestions found for dropdown fields error message. Maximum 64 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

block.multipleChoice.other

string

Other answer message. Maximum 100 characters.

label.progress.percent

string

Completion percentage message. Accepts variable progress:percent. Maximum 100 characters.

label.progress.proportion

string

Completion proportion message. Accepts variables progress:step and progress:total. Maximum 100 characters.

label.error.required

string

Required field error message. Maximum 64 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.preview

string

Review fields error message. Accepts variable form:unanswered_fields. Maximum 64 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.button.review

string

Review button message. Maximum 100 characters.

label.error.server

string

Server error message. Maximum 128 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.action.share

string

Share text message. Maximum 100 characters.

label.button.submit

string

Submit button message. Maximum 100 characters.

label.warning.success

string

Successful submit message. Maximum 128 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.button.ok

string

Answer confirm. Maximum 100 characters.

label.error.mustAccept

string

Legal field terms and conditions message. Maximum 64 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

block.longtext.hint

string

Long text field tooltip message. Maximum 128 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

block.dropdown.placeholder

string

Placeholder message with instructions for dropdown fields. Maximum 100 characters.

block.dropdown.placeholderTouch

string

Placeholder message with instructions for dropdown fields on touch devices. Maximum 100 characters.

label.error.url

string

Invalid URL error message. Maximum 64 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.yes.shortcut

string

Keyboard shortcut for the "Yes" option. Maximum 1 character.

label.yes.default

string

Representation for the word "Yes". You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

Response

Status

204 OK