# Update a specific Verification Service.

**POST /v2/Services/{Sid}**

Update a specific Verification Service.


## Servers
- https://verify.twilio.com: https://verify.twilio.com ()


## Authentication methods
- Account sid auth token


## Parameters

### Path parameters
- **Sid** (string)
  The Twilio-provided string that uniquely identifies the Service resource to update.


### Body: application/x-www-form-urlencoded (object)

- **FriendlyName** (string)
  A descriptive string that you create to describe the verification service. It can be up to 32 characters long. **This value should not contain PII.**
- **CodeLength** (integer)
  The length of the verification code to generate. Must be an integer value between 4 and 10, inclusive.
- **LookupEnabled** (boolean)
  Whether to perform a lookup with each verification started and return info about the phone number.
- **SkipSmsToLandlines** (boolean)
  Whether to skip sending SMS verifications to landlines. Requires `lookup_enabled`.
- **DtmfInputRequired** (boolean)
  Whether to ask the user to press a number before delivering the verify code in a phone call.
- **TtsName** (string)
  The name of an alternative text-to-speech service to use in phone calls. Applies only to TTS languages.
- **Psd2Enabled** (boolean)
  Whether to pass PSD2 transaction parameters when starting a verification.
- **DoNotShareWarningEnabled** (boolean)
  Whether to add a privacy warning at the end of an SMS. **Disabled by default and applies only for SMS.**
- **CustomCodeEnabled** (boolean)
  Whether to allow sending verifications with a custom code instead of a randomly generated one.
- **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.
- **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.
- **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
- **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
- **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.
- **Whatsapp.MsgServiceSid** (string)
  The SID of the [Messaging Service](https://www.twilio.com/docs/messaging/services) to associate with the Verification Service.
- **Whatsapp.From** (string)
  The WhatsApp number to use as the sender of the verification messages. This number must be associated with the WhatsApp Message Service.
- **VerifyEventSubscriptionEnabled** (boolean)
  Whether to allow verifications from the service to reach the stream-events sinks if configured


## Responses
### 200
OK
#### Headers
- **Access-Control-Allow-Origin** (string)
  Specify the origin(s) allowed to access the resource
- **Access-Control-Allow-Methods** (string)
  Specify the HTTP methods allowed when accessing the resource
- **Access-Control-Allow-Headers** (string)
  Specify the headers allowed when accessing the resource
- **Access-Control-Allow-Credentials** (boolean)
  Indicates whether the browser should include credentials
- **Access-Control-Expose-Headers** (string)
  Headers exposed to the client

#### Body: application/json (object)
- **sid** (string | null)
  The unique string that we created to identify the Service resource.
- **account_sid** (string | null)
  The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Service resource.
- **friendly_name** (string | null)
  The name that appears in the body of your verification messages. It can be up to 30 characters long and can include letters, numbers, spaces, dashes, underscores. Phone numbers, special characters or links are NOT allowed. It cannot contain more than 4 (consecutive or non-consecutive) digits. **This value should not contain PII.**
- **code_length** (integer)
  The length of the verification code to generate.
- **lookup_enabled** (boolean | null)
  Whether to perform a lookup with each verification started and return info about the phone number.
- **psd2_enabled** (boolean | null)
  Whether to pass PSD2 transaction parameters when starting a verification.
- **skip_sms_to_landlines** (boolean | null)
  Whether to skip sending SMS verifications to landlines. Requires `lookup_enabled`.
- **dtmf_input_required** (boolean | null)
  Whether to ask the user to press a number before delivering the verify code in a phone call.
- **tts_name** (string | null)
  The name of an alternative text-to-speech service to use in phone calls. Applies only to TTS languages.
- **do_not_share_warning_enabled** (boolean | null)
  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`
- **custom_code_enabled** (boolean | null)
  Whether to allow sending verifications with a custom code instead of a randomly generated one.
- **push** ()
  Configurations for the Push factors (channel) created under this Service.
- **totp** ()
  Configurations for the TOTP factors (channel) created under this Service.
- **default_template_sid** (string | null)

- **whatsapp** ()

- **verify_event_subscription_enabled** (boolean | null)
  Whether to allow verifications from the service to reach the stream-events sinks if configured
- **date_created** (string(date-time) | null)
  The date and time in GMT when the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
- **date_updated** (string(date-time) | null)
  The date and time in GMT when the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
- **url** (string(uri) | null)
  The absolute URL of the resource.
- **links** (object(uri-map) | null)
  The URLs of related resources.


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