# Create a new Webhook for the Service

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

Create a new Webhook for the Service


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


## Authentication methods
- Account sid auth token


## Parameters

### Path parameters
- **ServiceSid** (string)
  The unique SID identifier of the Service.


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

- **FriendlyName** (string)
  The string that you assigned to describe the webhook. **This value should not contain PII.**
- **EventTypes** (array[string])
  The array of events that this Webhook is subscribed to. Possible event types: `*, factor.deleted, factor.created, factor.verified, challenge.approved, challenge.denied`
- **WebhookUrl** (string)
  The URL associated with this Webhook.
- **Status** (string)
  The webhook status. Default value is `enabled`. One of: `enabled` or `disabled`
- **Version** (string)
  The webhook version. Default value is `v2` which includes all the latest fields. Version `v1` is legacy and may be removed in the future.


## Responses
### 201
Created
#### 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 Webhook resource.
- **service_sid** (string | null)
  The unique SID identifier of the Service.
- **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 string that you assigned to describe the webhook. **This value should not contain PII.**
- **event_types** (array[string] | null)
  The array of events that this Webhook is subscribed to. Possible event types: `*, factor.deleted, factor.created, factor.verified, challenge.approved, challenge.denied`
- **status** (string)
  The webhook status. Default value is `enabled`. One of: `enabled` or `disabled`
- **version** (string)
  The webhook version. Default value is `v2` which includes all the latest fields. Version `v1` is legacy and may be removed in the future.
- **webhook_url** (string(uri) | null)
  The URL associated with this Webhook.
- **webhook_method** (string)
  The method to be used when calling the webhook's URL.
- **date_created** (string(date-time) | null)
  The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
- **date_updated** (string(date-time) | null)
  The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
- **url** (string(uri) | null)
  The absolute URL of the Webhook resource.


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