---
title: "Create new OAuth client"
method: POST
path: "/tyk/oauth/clients/create"
tags: ["OAuth"]
---

# Create new OAuth client

`POST /tyk/oauth/clients/create`

Any OAuth keys must be generated with the help of a client ID. These need to be pre-registered with Tyk before they can be used (in a similar vein to how you would register your app with Twitter before attempting to ask user permissions using their API).
        <br/><br/>
        <h3>Creating OAuth clients with Access to Multiple APIs</h3>
        New from Tyk Gateway 2.6.0 is the ability to create OAuth clients with access to more than one API. If you provide the api_id it works the same as in previous releases. If you don't provide the api_id the request uses policy access rights and enumerates APIs from their setting in the newly created OAuth-client.

## Request body

- NewClientRequest
  - `api_id` string
  - `client_id` string
  - `description` string
  - `meta_data` object, nullable
  - `policy_id` string
  - `redirect_uri` string
  - `secret` string

## Response `200`

Client created

- NewClientRequest
  - `api_id` string
  - `client_id` string
  - `description` string
  - `meta_data` object, nullable
  - `policy_id` string
  - `redirect_uri` string
  - `secret` string

## Other responses

- `400` — Api Not found
- `403` — Forbidden
- `500` — Unmarshalling failed

## Changes

- **2024-09-18** `111affa17abe` — 1 breaking, 4 info
  - the response property `meta_data` became nullable for the status `200`
  - the request property `meta_data` became nullable
  - added the non-success response with the status `400`
  - added the non-success response with the status `403`
  - …1 more
- **2022-05-24** `111d8ca21864` — 1 breaking, 3 info
  - the request property `meta_data` became not nullable
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `403`
  - removed the non-success response with the status `500`

[Change history](https://skmtc.dev/tyktechnologies/apis/tyk-gateway-api/changes/tyk/oauth/clients/create/post.md)

---

[API](https://skmtc.dev/tyktechnologies/apis/tyk-gateway-api.md) · [All operations](https://skmtc.dev/tyktechnologies/apis/tyk-gateway-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tyktechnologies/tyk-gateway-api/revisions/900d0a33ae1d/schema)