Skip to content

Reference

ledger.createIdentityProviderConfig

POST /v2/idps — register a new identity provider configuration.

Creates a provider configuration (issuer, jwksUrl, optional audience, isDeactivated) under identityProviderId.

Receiver: await canton.ledger.createIdentityProviderConfig

Setup

import { Canton } from '@fairmint/canton-node-sdk';

const canton = new Canton({
  network: 'devnet',
  provider: '5n',
  partyId: 'OWN_PARTY_ID',
});

Minimal example

await canton.ledger.createIdentityProviderConfig({
  identityProviderConfig: {
    identityProviderId: 'custom-oidc',
    isDeactivated: false,
    issuer: 'https://issuer.example',
    jwksUrl: 'https://issuer.example/.well-known/jwks.json',
    audience: 'ledger-api',
  },
});

Parameters — CreateIdentityProviderConfigParams

  • identityProviderConfig (required) — Fields enumerated by CreateIdentityProviderConfigParamsSchema.

Returns — CreateIdentityProviderConfigResponse

Echo / acknowledgement payload.

Errors and pitfalls

Duplicate identityProviderId collisions reject create attempts—retrieve via getIdentityProviderConfig before deciding between patch vs create.

Auth and party

Participant identity-provider admin privileges required.

See also

Source

operations/v2/idps/post.ts