# Create a confirmation for a Postbox item

Creates a confirmation for the Postbox item specified in the request URL and sets 'has_been_confirmed' to  true for the item

Endpoint: POST /v1/postbox/items/{item_id}/confirmations
Version: 1.0

## Path parameters:

  - `item_id` (string, required)
    ID of the Postbox item.

## Request fields (application/json):

  - `person_id` (string)
    ID of the person who is confirming the Postbox item.
    Example: "28a2197ff6e04a05b6316f83a38ccper"

  - `idempotency_key` (string)
    Optional property you may supply to prevent the execution of duplicate requests. If the API receives a request with a previously used idempotency key, then it will return the previously created confirmation.

## Response 200 fields (application/json):

  - `id` (string)
    ID of the confirmation.

  - `person_id` (string)
    ID of the person who confirmed the Postbox item.

  - `confirmed_at` (string)
    UTC timestamp from when the person confirmed the Postbox item.

## Response 400 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "400"

  - `code` (string)
    Example: "build_pagination_headers_failure"

  - `title` (string)
    Example: "Failed to build pagination headers."

  - `detail` (string)
    Example: "Cannot connect to database."

## Response 403 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "403"

  - `code` (string)
    Example: "unauthorized_action"

  - `title` (string)
    Example: "Unauthorized Action"

  - `detail` (string)
    Example: "Unauthorized action is not allowed."

## Response 404 fields (application/json):

  - `errors` (array)

  - `errors.id` (string)

  - `errors.status` (integer)

  - `errors.code` (string)

  - `errors.title` (string)

  - `errors.detail` (string)

  - `errors.source` (object)

  - `errors.source.field` (string)

  - `errors.source.message` (string)

## Response 500 fields (application/json):

  - `id` (string)
    Example: "e8915041-9d8c-4d96-9dd1-04e8522ecdbf"

  - `status` (string)
    Example: "500"

  - `code` (string)
    Example: "generic_error"

  - `title` (string)
    Example: "Generic Error"

  - `detail` (string)
    Example: "There was an error."