---
title: "POST /v1alpha1/settings/issuer"
method: POST
path: "/v1alpha1/settings/issuer"
tags: ["SettingsService"]
---

# POST /v1alpha1/settings/issuer

`POST /v1alpha1/settings/issuer`

Set up Issuer

## Request body

- SetIssuerRequest
  - `issuerSettings` IssuerSettings, required — Issuer Settings
    - `issuerId` string — A unique identifier for the Issuer. This is typically the Issuer's ID in the Identity.
    - `idpType` 'IDP_TYPE_UNSPECIFIED' | 'IDP_TYPE_DUO' | 'IDP_TYPE_OKTA' | 'IDP_TYPE_ORY' | 'IDP_TYPE_SELF' | 'IDP_TYPE_KEYCLOAK' | 'IDP_TYPE_PING' | 'IDP_TYPE_ENTRA_ID', enum, required — The type of the IdP.
    - `duoIdpSettings` DuoIdpSettings — Duo IdP Settings
      - `hostname` string
      - `integrationKey` string
      - `secretKey` string
    - `oktaIdpSettings` OktaIdpSettings — Okta IdP Settings
      - `orgUrl` string
      - `clientId` string
      - `privateKey` string
    - `oryIdpSettings` OryIdpSettings — Ory IdP Settings
      - `projectSlug` string
      - `apiKey` string
    - `keycloakIdpSettings` KeycloakIdpSettings — Keycloak IdP Settings
      - `baseUrl` string
      - `realm` string
      - `clientId` string
      - `clientSecret` string
    - `pingIdpSettings` PingIdpSettings — Ping IdP Settings
      - `environmentId` string
      - `clientId` string
      - `clientSecret` string
      - `region` string
    - `entraIdpSettings` EntraIdpSettings — Entra ID (Azure AD) IdP Settings
      - `tenantId` string
      - `clientId` string
      - `clientSecret` string
    - `createdAt` string, date-time — CreatedAt records the timestamp of when the IssuerSettings was initially created
    - `updatedAt` string, date-time — UpdatedAt records the timestamp of the last update to the IssuerSettings

## Response `200`

OK

- IssuerSettings — Issuer Settings
  - `issuerId` string — A unique identifier for the Issuer. This is typically the Issuer's ID in the Identity.
  - `idpType` 'IDP_TYPE_UNSPECIFIED' | 'IDP_TYPE_DUO' | 'IDP_TYPE_OKTA' | 'IDP_TYPE_ORY' | 'IDP_TYPE_SELF' | 'IDP_TYPE_KEYCLOAK' | 'IDP_TYPE_PING' | 'IDP_TYPE_ENTRA_ID', enum, required — The type of the IdP.
  - `duoIdpSettings` DuoIdpSettings — Duo IdP Settings
    - `hostname` string
    - `integrationKey` string
    - `secretKey` string
  - `oktaIdpSettings` OktaIdpSettings — Okta IdP Settings
    - `orgUrl` string
    - `clientId` string
    - `privateKey` string
  - `oryIdpSettings` OryIdpSettings — Ory IdP Settings
    - `projectSlug` string
    - `apiKey` string
  - `keycloakIdpSettings` KeycloakIdpSettings — Keycloak IdP Settings
    - `baseUrl` string
    - `realm` string
    - `clientId` string
    - `clientSecret` string
  - `pingIdpSettings` PingIdpSettings — Ping IdP Settings
    - `environmentId` string
    - `clientId` string
    - `clientSecret` string
    - `region` string
  - `entraIdpSettings` EntraIdpSettings — Entra ID (Azure AD) IdP Settings
    - `tenantId` string
    - `clientId` string
    - `clientSecret` string
  - `createdAt` string, date-time — CreatedAt records the timestamp of when the IssuerSettings was initially created
  - `updatedAt` string, date-time — UpdatedAt records the timestamp of the last update to the IssuerSettings

## Other responses

- `default` — Default error response

---

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