---
title: "POST /challenges"
method: POST
path: "/challenges"
---

# POST /challenges

`POST /challenges`

For general-purpose connectors. Creates a _challenge password_ for the specified connector. The SCEP protocol uses a challenge password to authenticate a request before issuing a certificate from a certificate authority (CA). Your SCEP clients include the challenge password as part of their certificate request to Connector for SCEP. To retrieve the connector Amazon Resource Names (ARNs) for the connectors in your account, call [ListConnectors](https://docs.aws.amazon.com/pca-connector-scep/latest/APIReference/API_ListConnectors.html).

To create additional challenge passwords for the connector, call `CreateChallenge` again. We recommend frequently rotating your challenge passwords.

## Request body

- object
  - `ConnectorArn` string, required — The Amazon Resource Name (ARN) of the connector that you want to create a challenge for.
  - `ClientToken` string — Custom string that can be used to distinguish between calls to the <a href="https://docs.aws.amazon.com/pca-connector-scep/latest/APIReference/API_CreateChallenge.html">CreateChallenge</a> action. Client tokens for <code>CreateChallenge</code> time out after five minutes. Therefore, if you call <code>CreateChallenge</code> multiple times with the same client token within five minutes, Connector for SCEP recognizes that you are requesting only one challenge and will only respond with one. If you change the client token for each call, Connector for SCEP recognizes that you are requesting multiple challenge passwords.
  - `Tags` object — The key-value pairs to associate with the resource.

## Response `202`

Success

- CreateChallengeResponse
  - `Challenge` object — Returns the challenge details for the specified connector.
    - `Arn` string — The Amazon Resource Name (ARN) of the challenge.
    - `ConnectorArn` string — The Amazon Resource Name (ARN) of the connector.
    - `CreatedAt` string, date-time — The date and time that the challenge was created.
    - `UpdatedAt` string, date-time — The date and time that the challenge was updated.
    - `Password` string, password — The SCEP challenge password, in UUID format.

## Other responses

- `480` — BadRequestException
- `481` — ResourceNotFoundException
- `482` — InternalServerException
- `483` — ValidationException
- `484` — ThrottlingException
- `485` — AccessDeniedException
- `486` — ConflictException
- `487` — ServiceQuotaExceededException

---

[API](https://skmtc.net/aws/apis/pca-connector-scep.md) · [All operations](https://skmtc.net/aws/apis/pca-connector-scep/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/pca-connector-scep/versions/a5c230d423d0/schema)