# Create a new Challenge for the Factor

**POST /v2/Services/{ServiceSid}/Entities/{Identity}/Challenges**

Create a new Challenge for the Factor
TODO: Resource-level docs

## Servers



## Parameters

### Path parameters
- **ServiceSid** (string)
  The unique SID identifier of the Service.
- **Identity** (string)
  Customer unique identity for the Entity owner of the Challenge. 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.


### Body:  (object)

- **AuthPayload** (string)
  Optional payload used to verify the Challenge upon creation. Only used with a Factor of type `totp` to carry the TOTP code that needs to be verified. For `TOTP` this value must be between 3 and 8 characters long.
- **Details.Fields** (array)
  A list of objects that describe the Fields included in the Challenge. Each object contains the label and value of the field, the label can be up to 36 characters in length and the value can be up to 128 characters in length. Used when `factor_type` is `push`. There can be up to 20 details fields.
- **Details.Message** (string)
  Shown to the user when the push notification arrives. Required when `factor_type` is `push`. Can be up to 256 characters in length
- **ExpirationDate** (string(date-time))
  The date-time when this Challenge expires, given in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. The default value is five (5) minutes after Challenge creation. The max value is sixty (60) minutes after creation.
- **FactorSid** (string)
  The unique SID identifier of the Factor.
- **HiddenDetails** ()
  Details provided to give context about the Challenge. Not shown to the end user. It must be a stringified JSON with only strings values eg. `{"ip": "172.168.1.234"}`. Can be up to 1024 characters in length


## Responses
### 201
Created

#### Body:  (object)
- **account_sid** (string | null)
  Account Sid.
- **date_created** (string(date-time) | null)
  The date this Challenge was created
- **date_responded** (string(date-time) | null)
  The date this Challenge was responded
- **date_updated** (string(date-time) | null)
  The date this Challenge was updated
- **details** ()
  Details about the Challenge.
- **entity_sid** (string | null)
  Entity Sid.
- **expiration_date** (string(date-time) | null)
  The date-time when this Challenge expires
- **factor_sid** (string | null)
  Factor Sid.
- **factor_type** (string | null)
  The Factor Type of this Challenge
- **hidden_details** ()
  Hidden details about the Challenge
- **identity** (string | null)
  Unique external identifier of the Entity
- **links** (object(uri-map) | null)
  Nested resource URLs.
- **metadata** ()
  Metadata of the challenge.
- **responded_reason** (string | null)
  The Reason of this Challenge `status`
- **service_sid** (string | null)
  Service Sid.
- **sid** (string | null)
  A string that uniquely identifies this Challenge.
- **status** (string | null)
  The Status of this Challenge
- **url** (string(uri) | null)
  The URL of this resource.


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