# Create a delivery event for an activation challenge

Registers a new delivery event that updates the delivery status of an activation challenge.

Endpoint: POST /v1/mfa/challenges/activation/{id}/delivery_events
Version: 1.0

## Request fields (application/json):

  - `type` (string, required)
    Current status of the delivery process.
    Example: "DISPATCHED"

  - `timestamp` (string, required)
    UTC timestamp of the event in RFC 3339 format.
    Example: "2018-06-18T13:06:54.000Z"

  - `provider` (string)
    Name of the provider used to deliver the activation code.
    Example: "DEUTSCHE POST"

  - `additional_details` (string)
    Additional details about the event.
    Example: "Booking id is 123E"

## Response 201 fields (application/json):

  - `id` (string)
    The ID of the challenge.
    Example: "6642d15e-8f6b-4d28-9186-cdd61d80032a"

  - `person_id` (string)
    The ID of the person for whom the activation code is created
    Example: "55e47118b78741dbb81cdd3d372bc448cpar"

  - `code` (string)
    activation code
    Example: "code123456abcd"

  - `created_at` (string)
    The date and time when the code was created.
    Example: "2022-03-18T14:50:04Z"

  - `expires_at` (string)
    The date and time when the code will expire.
    Example: "2022-03-18T14:55:04Z"

  - `origin` (string)
    Origin of the request. Origin specifed while creating a new activation code is returned here. "SOLARISBANK" is a reserved origin value which will be used by solarisbank for internally generated requests.
    Example: "MOBILE_APP"

  - `purpose` (string)
    Purpose of the activation_code.  The generated activation_code can be used only for the desired purpose. Currently the only supported purpose is DEVICE_BINDING. More purposes may be supported in future.
    Example: "DEVICE_BINDING"

  - `delivery_method` (string)
    Partner's method of delivering activation code to the endcustomer.
    Example: "SNAILMAIL"

  - `usage_count` (integer)
    The number of times the activation code has been used.
    Example: 1

  - `max_usage_count` (integer)
    The maximum number of times the activation code can be used.
    Example: 5

## Response 400 fields (application/json):

  - `errors` (array)

  - `errors.id` (string, required)
    Correlation/Request ID

  - `errors.status` (integer, required)

  - `errors.code` (string, required)

  - `errors.title` (string, required)

  - `errors.detail` (string, required)

  - `errors.source` (object)

  - `errors.source.field` (string)

  - `errors.source.message` (string)

  - `errors.error_code` (string)
    Correlation/Request ID

## Response 401 fields (application/json):

  - `errors` (array)

  - `errors.id` (string, required)
    Correlation/Request ID

  - `errors.status` (integer, required)

  - `errors.code` (string, required)

  - `errors.title` (string, required)

  - `errors.detail` (string, required)

  - `errors.source` (object)

  - `errors.source.field` (string)

  - `errors.source.message` (string)

  - `errors.error_code` (string)
    Correlation/Request ID

## Response 403 fields (application/json):

  - `errors` (array)

  - `errors.id` (string, required)
    Correlation/Request ID

  - `errors.status` (integer, required)

  - `errors.code` (string, required)

  - `errors.title` (string, required)

  - `errors.detail` (string, required)

  - `errors.source` (object)

  - `errors.source.field` (string)

  - `errors.source.message` (string)

  - `errors.error_code` (string)
    Correlation/Request ID

## Response 404 fields (application/json):

  - `errors` (array)

  - `errors.id` (string, required)
    Correlation/Request ID

  - `errors.status` (integer, required)

  - `errors.code` (string, required)

  - `errors.title` (string, required)

  - `errors.detail` (string, required)

  - `errors.source` (object)

  - `errors.source.field` (string)

  - `errors.source.message` (string)

  - `errors.error_code` (string)
    Correlation/Request ID

## Response 500 fields (application/json):

  - `errors` (array)

  - `errors.id` (string, required)
    Correlation/Request ID

  - `errors.status` (integer, required)

  - `errors.code` (string, required)

  - `errors.title` (string, required)

  - `errors.detail` (string, required)

  - `errors.source` (object)

  - `errors.source.field` (string)

  - `errors.source.message` (string)

  - `errors.error_code` (string)
    Correlation/Request ID