# Create a new Verification using a Service

**POST /v2/Services/{ServiceSid}/Verifications**

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

## Servers



## Parameters

### Path parameters
- **ServiceSid** (string)
  The SID of the verification [Service](https://www.twilio.com/docs/verify/api/service) to create the resource under.


### Body:  (object)

- **Amount** (string)
  The amount of the associated PSD2 compliant transaction. Requires the PSD2 Service flag enabled.
- **AppHash** (string)
  Your [App Hash](https://developers.google.com/identity/sms-retriever/verify#computing_your_apps_hash_string) to be appended at the end of your verification SMS body. Applies only to SMS. Example SMS body: `<#> Your AppName verification code is: 1234 He42w354ol9`.
- **Channel** (string)
  The verification method to use. Can be: [`email`](https://www.twilio.com/docs/verify/email), `sms`, `whatsapp` or `call`.
- **ChannelConfiguration** ()
  [`email`](https://www.twilio.com/docs/verify/email) channel configuration in json format. The fields 'from' and 'from_name' are optional but if included the 'from' field must have a valid email address.
- **CustomCode** (string)
  A pre-generated code to use for verification. The code can be between 4 and 10 characters, inclusive.
- **CustomFriendlyName** (string)
  A custom user defined friendly name that overwrites the existing one in the verification message
- **CustomMessage** (string)
  The text of a custom message to use for the verification.
- **Locale** (string)
  The locale to use for the verification SMS, WhatsApp or call. Can be: `af`, `ar`, `ca`, `cs`, `da`, `de`, `el`, `en`, `en-GB`, `es`, `fi`, `fr`, `he`, `hi`, `hr`, `hu`, `id`, `it`, `ja`, `ko`, `ms`, `nb`, `nl`, `pl`, `pt`, `pr-BR`, `ro`, `ru`, `sv`, `th`, `tl`, `tr`, `vi`, `zh`, `zh-CN`, or `zh-HK.`
- **Payee** (string)
  The payee of the associated PSD2 compliant transaction. Requires the PSD2 Service flag enabled.
- **RateLimits** ()
  The custom key-value pairs of Programmable Rate Limits. Keys correspond to `unique_name` fields defined when [creating your Rate Limit](https://www.twilio.com/docs/verify/api/service-rate-limits). Associated value pairs represent values in the request that you are rate limiting on. You may include multiple Rate Limit values in each request.
- **SendDigits** (string)
  The digits to send after a phone call is answered, for example, to dial an extension. For more information, see the Programmable Voice documentation of [sendDigits](https://www.twilio.com/docs/voice/twiml/number#attributes-sendDigits).
- **TemplateCustomSubstitutions** (string)
  A stringified JSON object in which the keys are the template's special variables and the values are the variables substitutions.
- **TemplateSid** (string)
  The message [template](https://www.twilio.com/docs/verify/api/templates). If provided, will override the default template for the Service. SMS channel only.
- **To** (string)
  The phone number or [email](https://www.twilio.com/docs/verify/email) to verify. Phone numbers must be in [E.164 format](https://www.twilio.com/docs/glossary/what-e164).


## Responses
### 201
Created

#### Body:  (object)
- **account_sid** (string | null)
  The SID of the Account that created the resource
- **amount** (string | null)
  The amount of the associated PSD2 compliant transaction.
- **channel** (string | null)
  The verification method used.
- **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
- **lookup** ()
  Information about the phone number being verified
- **payee** (string | null)
  The payee of the associated PSD2 compliant transaction
- **send_code_attempts** (array | null)
  An array of verification attempt objects.
- **service_sid** (string | null)
  The SID of the Service that the resource is associated with
- **sid** (string | null)
  The unique string that identifies the resource
- **status** (string | null)
  The status of the verification resource
- **to** (string | null)
  The phone number or email being verified
- **url** (string(uri) | null)
  The absolute URL of the Verification resource
- **valid** (boolean | null)
  Whether the verification was successful


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