# Add authorized person to person account

Adds an existing person to a person account as an authorized person. : This call triggers the change request process.

Endpoint: POST /v1/persons/{person_id}/accounts/{account_id}/authorized_persons
Version: 1.0

## Path parameters:

  - `person_id` (string, required)

  - `account_id` (string, required)

## Request fields (application/json):

  - `authorized_person_id` (string)
    The ID of the person to add to the account as an authorized person.
    Example: "0ba2211cab11af6094d60ead81f2bd9dcper"

  - `skip_2fa` (boolean)
    Skip change request, add authorized person without 2fa (Optional). Skipping change request works only if the partner settings are adjusted to allow the skip.

## Response 201 fields (application/json):

  - `id` (string)
    ID of the authorized person relationship.
    Example: "c25ac6d8a4774e0dacb61a70427e0782"

  - `authorized_person_id` (string)
    Person ID of the authorized person.
    Example: "0ba2211cab11af6094d60ead81f2bd9dcper"

  - `valid_from` (string)
    The date from which the authorized person has been authorized on the account.
    Example: "2021-04-01"

  - `valid_until` (string)
    The date until which the authorized person is authorized on the account.
    Example: "2031-04-01"

## Response 202 fields (application/json):

  - `id` (string)
    ID of the change request.
    Example: "d6c778822b2d7bd3b778935bcfd0d1d3csc"

  - `status` (string)
    The current status of the change request.
    Enum: "ACCEPTED", "AUTHORIZATION_REQUIRED", "CONFIRMATION_REQUIRED", "COMPLETED", "FAILED"

  - `updated_at` (string)
    UTC timestamp from the last time the change request was updated.
    Example: "2022-04-21T13:59:52+00:00"

  - `url` (string)
    URL to use to authorize the change request.
    Example: "https://example.com/authorize"

## 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):

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

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

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

  - `title` (string)
    Example: "Model Not Found"

  - `detail` (string)
    Example: "Couldn't find 'Solaris::Identification' for id 'bbbcccfff388923eb899a5852df6cidt'."

## 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."