---
title: "Manual authenticate of credentials"
method: POST
path: "/api/v1/credentials/{id}/authenticate"
tags: ["Connectivity v1.Credentials"]
---

# Manual authenticate of credentials

`POST /api/v1/credentials/{id}/authenticate`

Triggers a full authentication flow to renew refresh tokens with ASPSPs. This endpoint only triggers authentication, thus a full credentials refresh will not be executed.

## Path parameters

- `id` string, required

## Request body

- ManualAuthenticationRequest — Manual authentication object.
  - `appUri` string — The end user will be redirected to this URI after the authorization code has been delivered. This field is used for flows where we have third party redirects to financial institutions. There is a default value which is tink://open. It can be any type of URI (mobile deeplink, http address etc.)
  - `callbackUri` string — This URI will be used by the ASPSP to pass the authorization code. It corresponds to the redirect/callback URI in OAuth2/OpenId. This parameter is only applicable if you are a TPP.
  - `originatingUserIp` string — The originating user's remote IP address of the corresponding HTTP request.
  - `selectedAuthenticationOptions` SelectedAuthenticationOption[] — [BETA] Specifies the selected authentication options for each available group when a provider has more than one authentication option available in any of the available groups.
    - `authenticationOptionDefinition` string — Specifies the selected authentication option. This is only required if selectedAuthenticationOptions is used.
    - `authenticationOptionsGroup` string — Specifies the authentication option group for which we have selected an authentication option. This is only required if selectedAuthenticationOptions is used.
    - `fields` object — Specifies the values for the fields that are required to be sent when this authentication option is selected, if any.

## Response `204`

The credentials authentication was successfully initiated.

## Other responses

- `404` — The credentials could not be found.

---

[API](https://skmtc.net/tink/apis/tink-api.md) · [All operations](https://skmtc.net/tink/apis/tink-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tink/tink-api/revisions/23d8982b533d/schema)