---
title: "POST /v2/Services/{ServiceSid}/Entities/{Identity}/Factors"
method: POST
path: "/v2/Services/{ServiceSid}/Entities/{Identity}/Factors"
---

# POST /v2/Services/{ServiceSid}/Entities/{Identity}/Factors

`POST /v2/Services/{ServiceSid}/Entities/{Identity}/Factors`

Create a new Factor for the Entity

## Path parameters

- `ServiceSid` string, required
- `Identity` string, required

## Response `201`

Created

- VerifyV2ServiceEntityNewFactor
  - `account_sid` string, nullable — The unique SID identifier of the Account.
  - `binding` unknown
  - `config` unknown
  - `date_created` string, date-time, nullable — The date that this Factor was created, given in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `date_updated` string, date-time, nullable — The date that this Factor was updated, given in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `entity_sid` string, nullable — The unique SID identifier of the Entity.
  - `factor_type` 'push' | 'totp'
  - `friendly_name` string, nullable — The friendly name of this Factor. This can be any string up to 64 characters, meant for humans to distinguish between Factors. For `factor_type` `push`, this could be a device name. For `factor_type` `totp`, this value is used as the “account name” in constructing the `binding.uri` property. At the same time, we recommend avoiding providing PII.
  - `identity` string, nullable — Customer unique identity for the Entity owner of the Factor. This identifier should be immutable, not PII, length between 8 and 64 characters, and generated by your external system, such as your user's UUID, GUID, or SID. It can only contain dash (-) separated alphanumeric characters.
  - `metadata` unknown
  - `service_sid` string, nullable — The unique SID identifier of the Service.
  - `sid` string, nullable — A 34 character string that uniquely identifies this Factor.
  - `status` 'unverified' | 'verified'
  - `url` string, uri, nullable — The URL of this resource.

---

[API](https://skmtc.net/twilio/apis/twilio-verify-v2.md) · [All operations](https://skmtc.net/twilio/apis/twilio-verify-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twilio/twilio-verify-v2/versions/b85b5e38502c/schema)