Sign in

v50

latestOpenAPI 3.1.0Apache 2.0raw.githubusercontent.com2026-07-068428533.0 MB
Centrally Managed Consumers

Create a consumer

Create a new consumer in this Realm. It will be available to use for authentication within a few seconds, unless the consumer's username is blocked in the Gateway. If this is the case, the new consumer will be available in negative_ttl (see the Realm definition) seconds.

post/v1/realms/{realmId}/consumers

Request body

usernamestring required

The unique username of the Consumer.

custom_idstring

Field for storing an existing unique ID for the Consumer - useful for mapping Kong with users in your existing database.

consumer_groupsstring[]

A list of consumer groups that the Consumer is in. If consumer_groups are provided on the Consumer object and on the Realm, the Consumer will be placed in all defined consumer groups.

type'proxy' | 'developer' | 'admin' | 'application'

Type of the consumer.

tagsstring[]

Response

success

idstring uuid required

The Consumer ID.

usernamestring required

The unique username of the Consumer. You must send either this field or custom_id with the request.

custom_idstring nullable required

Field for storing an existing unique ID for the Consumer - useful for mapping Kong with users in your existing database. You must send either this field or username with the request.

type'proxy' | 'developer' | 'admin' | 'application' required

Type of the consumer.

tagsstring[] required
consumer_groupsstring[] required

A list of consumer groups that the Consumer is in. If consumer_groups are provided on the Consumer object and on the Realm, the Consumer will be placed in all defined consumer groups.

created_atstring date-time required

An ISO-8601 timestamp representation of entity creation date.

updated_atstring date-time required

An ISO-8601 timestamp representation of entity update date.

Example response

{
  "custom_id": "4200",
  "id": "8a388226-80e8-4027-a486-25e4f7db5d21",
  "type": "proxy",
  "consumer_groups": [
    "gold"
  ],
  "tags": [
    "partner"
  ],
  "username": "bob-the-builder",
  "created_at": "2025-06-17T16:55:58.569399532Z",
  "updated_at": "2025-06-17T16:55:58.569399532Z"
}