# Create a new Verification Service

**POST /v2/Services**

Create a new Verification Service.
TODO: Resource-level docs

## Servers



## Parameters



### Body:  (object)

- **CodeLength** (integer)
  The length of the verification code to generate. Must be an integer value between 4 and 10, inclusive.
- **CustomCodeEnabled** (boolean)
  Whether to allow sending verifications with a custom code instead of a randomly generated one. Not available for all customers.
- **DefaultTemplateSid** (string)
  The default message [template](https://www.twilio.com/docs/verify/api/templates). Will be used for all SMS verifications unless explicitly overriden. SMS channel only.
- **DoNotShareWarningEnabled** (boolean)
  Whether to add a security warning at the end of an SMS verification body. Disabled by default and applies only to SMS. Example SMS body: `Your AppName verification code is: 1234. Don’t share this code with anyone; our employees will never ask for the code`
- **DtmfInputRequired** (boolean)
  Whether to ask the user to press a number before delivering the verify code in a phone call.
- **FriendlyName** (string)
  A descriptive string that you create to describe the verification service. It can be up to 30 characters long. **This value should not contain PII.**
- **LookupEnabled** (boolean)
  Whether to perform a lookup with each verification started and return info about the phone number.
- **Psd2Enabled** (boolean)
  Whether to pass PSD2 transaction parameters when starting a verification.
- **Push.ApnCredentialSid** (string)
  Optional configuration for the Push factors. Set the APN Credential for this service. This will allow to send push notifications to iOS devices. See [Credential Resource](https://www.twilio.com/docs/notify/api/credential-resource)
- **Push.FcmCredentialSid** (string)
  Optional configuration for the Push factors. Set the FCM Credential for this service. This will allow to send push notifications to Android devices. See [Credential Resource](https://www.twilio.com/docs/notify/api/credential-resource)
- **Totp.Issuer** (string)
  Optional configuration for the TOTP factors. Set TOTP Issuer for this service. This will allow to configure the issuer of the TOTP URI. Defaults to the service friendly name if not provided.
- **Push.IncludeDate** (boolean)
  Optional configuration for the Push factors. If true, include the date in the Challenge's response. Otherwise, the date is omitted from the response. See [Challenge](https://www.twilio.com/docs/verify/api/challenge) resource’s details parameter for more info. Default: false. **Deprecated** do not use this parameter. This timestamp value is the same one as the one found in `date_created`, please use that one instead.
- **SkipSmsToLandlines** (boolean)
  Whether to skip sending SMS verifications to landlines. Requires `lookup_enabled`.
- **Totp.CodeLength** (integer)
  Optional configuration for the TOTP factors. Number of digits for generated TOTP codes. Must be between 3 and 8, inclusive. Defaults to 6
- **Totp.Skew** (integer)
  Optional configuration for the TOTP factors. The number of time-steps, past and future, that are valid for validation of TOTP codes. Must be between 0 and 2, inclusive. Defaults to 1
- **Totp.TimeStep** (integer)
  Optional configuration for the TOTP factors. Defines how often, in seconds, are TOTP codes generated. i.e, a new TOTP code is generated every time_step seconds. Must be between 20 and 60 seconds, inclusive. Defaults to 30 seconds
- **TtsName** (string)
  The name of an alternative text-to-speech service to use in phone calls. Applies only to TTS languages.


## Responses
### 201
Created

#### Body:  (object)
- **account_sid** (string | null)
  The SID of the Account that created the resource
- **code_length** (integer | null)
  The length of the verification code
- **custom_code_enabled** (boolean | null)
  Whether to allow sending verifications with a custom code.
- **date_created** (string(date-time) | null)
  The RFC 2822 date and time in GMT when the resource was created
- **date_updated** (string(date-time) | null)
  The RFC 2822 date and time in GMT when the resource was last updated
- **default_template_sid** (string | null)

- **do_not_share_warning_enabled** (boolean | null)
  Whether to add a security warning at the end of an SMS.
- **dtmf_input_required** (boolean | null)
  Whether to ask the user to press a number before delivering the verify code in a phone call
- **friendly_name** (string | null)
  The string that you assigned to describe the verification service
- **links** (object(uri-map) | null)
  The URLs of related resources
- **lookup_enabled** (boolean | null)
  Whether to perform a lookup with each verification
- **psd2_enabled** (boolean | null)
  Whether to pass PSD2 transaction parameters when starting a verification
- **push** ()
  The service level configuration of factor push type.
- **sid** (string | null)
  The unique string that identifies the resource
- **skip_sms_to_landlines** (boolean | null)
  Whether to skip sending SMS verifications to landlines
- **totp** ()
  The service level configuration of factor TOTP type.
- **tts_name** (string | null)
  The name of an alternative text-to-speech service to use in phone calls
- **url** (string(uri) | null)
  The absolute URL of the resource


[Powered by Bump.sh](https://bump.sh)