---
title: "Changes to Create a new Factor for the Entity"
method: POST
path: "/v2/Services/{ServiceSid}/Entities/{Identity}/Factors"
---

# Changes to Create a new Factor for the Entity

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

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 4 of 52 revisions.

- **2025-08-18** (v2) `3fd4376faab5` — 1 warning, 2 info
- **2025-07-03** (v2) `1548692e6804` — 3 breaking, 1 info
- **2025-03-11** (v2) `43e0e113369c` — 4 breaking
- **2023-08-10** (v2) `fb6ded97d73f` — 1 info

## Changes

- **2025-08-18** (v2) `3fd4376faab5` — 1 warning, 2 info
  - added the new `passkeys` enum value to the `factor_type` response property for the response status `201`
  - added the new `passkeys` enum value to the request property `FactorType`
  - added the optional property `options` to the response with the `201` status
- **2025-07-03** (v2) `1548692e6804` — 3 breaking, 1 info
  - the `binding` response's property type changed from `object` to no type for status `201`
  - the `config` response's property type changed from `object` to no type for status `201`
  - the `metadata` response's property type changed from `object` to no type for status `201`
  - the `Metadata` request property type was generalized from `object` to no type
- **2025-03-11** (v2) `43e0e113369c` — 4 breaking
  - the `Metadata` request property type changed from no type to `object`
  - the `binding` response's property type changed from no type to `object` for status `201`
  - the `config` response's property type changed from no type to `object` for status `201`
  - the `metadata` response's property type changed from no type to `object` for status `201`
- **2023-08-10** (v2) `fb6ded97d73f` — 1 info
  - api tag `VerifyV2NewFactor` added

---

[Operation](https://skmtc.dev/twilio/apis/verify-v2/docs/v2/Services/:ServiceSid/Entities/:Identity/Factors/post.md) · [API](https://skmtc.dev/twilio/apis/verify-v2.md) · [Page](https://skmtc.dev/twilio/apis/verify-v2/changes/v2/Services/:ServiceSid/Entities/:Identity/Factors/post)