---
"@context": https://schema.org
"@type": TechArticle
"@id": https://www.twilio.com/docs/api/errors/13217#article
headline: "13217: Dial: Invalid record value"
url: https://www.twilio.com/docs/api/errors/13217
inLanguage: en
dateModified: 2026-06-08T11:29:20.000Z
author:
  "@type": Organization
  name: Twilio Developer Education Team
publisher:
  "@type": Organization
  name: Twilio
---

# 13217: Dial: Invalid record value

Log Level: WARNING

## Description

Twilio raises this warning when your `<Dial>` verb includes a `record` attribute value that Twilio does not support. This error returns the message `record must be "true" or "false"`. For `<Dial>`, supported recording values are `do-not-record`, `record-from-answer`, `record-from-ringing`, `record-from-answer-dual`, and `record-from-ringing-dual`. For backward compatibility, `true` maps to `record-from-answer` and `false` maps to `do-not-record`.

### Possible causes

* Your `<Dial>` verb sets `record` to a value that is not one of the supported recording options.
* Your application sends a typo, unexpected capitalization, or extra characters in the `record` value, so Twilio cannot match it to a valid option.
* Your application builds TwiML dynamically and the variable used for `record` resolves to an empty or unsupported value at runtime.

### Possible solutions

* Update the `<Dial>` verb so the `record` attribute uses a supported value such as `do-not-record`, `record-from-answer`, `record-from-ringing`, `record-from-answer-dual`, or `record-from-ringing-dual`.
* If you use the legacy boolean form, set `record="true"` to use `record-from-answer`, or set `record="false"` to use `do-not-record`.
* Review any code or template logic that generates your TwiML and confirm it outputs the exact `record` value you expect before Twilio processes the `<Dial>` verb.

#### Additional resources

* [TwiML Voice: `<Dial>`](/docs/voice/twiml/dial)
* [Recordings resource](/docs/voice/api/recording)
* [How to Record a Phone Call with Twilio](https://help.twilio.com/articles/223132867-Recording-a-phone-call-with-Twilio)
