---
title: "Create OpenId Connect Transaction"
method: POST
path: "/v1/organizations/{organization_id}/transactions/identity"
tags: ["Transactions"]
---

# Create OpenId Connect Transaction

`POST /v1/organizations/{organization_id}/transactions/identity`

## Request

- Base URL: `https://api.proof.com`
- URL: `https://api.proof.com/v1/organizations/{organization_id}/transactions/identity`
- Auth: API key in header `ApiKey`

## Path parameters

- `organization_id` string, required

## Request body

- OpenidConnectTransactionCreateParams
  - `request` OauthRedirect
    - `client_id` string: OAuth client ID to issue resulting tokens to
    - `redirect_uri` string: Registered OAuth redirect URL for redirecting the user to after the transaction is completed
    - `scope` string, nullable: Set to the OpenId Connect standard value 'openid' to receive an ID token after OAuth code exchange
    - `state` string, nullable: OAuth state parameter; a string returned intact on the query string of the resulting redirect
  - `workflow` OpenidConnectTransactionWorkflow
    - `id` 'proof.kba.default' | 'proof.ca.default'
    - `parameters` OpenidConnectTransactionRequestParameter[], nullable
      - `name` 'first_name' | 'last_name'
      - `value` string
      - `locked` boolean
  - `external_user_id` string

## Response `200`

successful

- OpenidConnectTransactionObject
  - `transaction_id` string: The resulting transaction ID for the created transaction
  - `access_link` string: The generated access link to send a user to for verification

## Other responses

- `400`: Invalid Parameter
- `403`: Forbidden

---

[API](https://skmtc.dev/proof/apis/proof-business-api-specification.md) · [All operations](https://skmtc.dev/proof/apis/proof-business-api-specification/llms.txt) · [OpenAPI document](https://skmtc.dev/proof/apis/proof-business-api-specification/revisions/1adaa0ea25cd?raw)