OAuth clients

Register an OAuth client

Authentication

Authorizationbearer token

Requires oauth.clients.write — Create and update OAuth clients, secrets, and icons.

Body parameters

application/json

namestringrequired

Application name shown during authorization.

redirectUrisURL[]required

Exact callback URLs allowed after authorization.

clientTypePUBLIC | CONFIDENTIAL

Use PUBLIC for clients that cannot safely store a secret.

descriptionstring

Application description shown to users.

websiteUrlURL

Public application website.

Responses

200Successful response

400The request is invalid

401Authentication is missing or invalid

403The token does not have the required scope

429Rate limit exceeded

const response = await fetch('https://api.ufw.dev/v1/developer/clients', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Acme Podcasts",
    "redirectUris": [
      "https://example.com/oauth/callback"
    ],
    "clientType": "PUBLIC"
  }),
});

const data = await response.json();

Response200

{
  "client_id": "ufw_client_4Qm2Zt",
  "client_secret": null,
  "client_type": "THIRD_PARTY",
  "next": "/account/developer?client=ufw_client_4Qm2Zt&created=1"
}