Skip to content

Create an authenticator group

Request

Early AccessIdentity Engine
OAuth 2.0 scope:
  • okta.policies.manage

Creates a new authenticator group.

An authenticator enrollment policy references the group to set how many of the group's authenticators that users must enroll.

Bodyapplication/jsonrequired
authenticatorsArray of objects(AuthenticatorGroupMember)

Authenticators that belong to the group

descriptionstring, <= 1024 characters

A short description of the authenticator group

namestring, <= 255 charactersrequired

Name of the authenticator group

Example:"Recovery Methods"
curl -i -X POST \
  https://subdomain.okta.com/api/v1/authenticator-groups \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Recovery Methods",
    "authenticators": [
      {
        "id": "aut1nd8PQhGcQtSxB0g4"
      },
      {
        "id": "aut2wzgRTbKxQmLpE0h7"
      },
      {
        "id": "aut3kq7MYfDwRbNtU1j2"
      }
    ]
  }'

Responses

Created

Bodyapplication/json
authenticatorsArray of objects(AuthenticatorGroupMember)

Authenticators that belong to the group

createdstring, (date-time)read-only

Timestamp of when the group was created

descriptionstring, <= 1024 characters

A short description of the authenticator group

idstringread-only

Unique identifier of the authenticator group

Example:"arg7xus97faIAgmti0"
lastUpdatedstring, (date-time)read-only

Timestamp of when the group was last modified

namestring, <= 255 charactersrequired

Name of the authenticator group

Example:"Recovery Methods"
Response
{ "id": "arg7xus97faIAgmti0", "name": "Recovery Methods", "authenticators": [ { … }, { … }, { … } ], "created": "2026-06-01T10:15:30.000Z", "lastUpdated": "2026-06-01T10:15:30.000Z", "_links": { "self": { … } } }