OAuth

OAuth2 client management

Create OAuth client

post

Create a new OAuth2 client application.

Required permissions, when user-scoped authentication is used: OAUTH_TOKEN_CREATE. Also, when the user-scoped authentication is used, user should have developer mode enabled.

Authorizations

bearerAuth

AuthorizationstringRequired

OAuth2 Bearer token obtained from authentication endpoint

Body

application/json

orgIdinteger · int32Optional

Organization ID, in which OAuth client will be created. If not provided, the organization, that is associated with the authentication token, will be used.

Example: 101

namestring · min: 1 · max: 64Required

Client application name

Example: My IoT App

redirectUrlsstring · uri[] · max: 10Optional

Redirect URIs

Example: https://myapp.com/oauth/callback

Responses

201

OAuth client created successfully

application/json

400

Bad request

application/json

403

Forbidden

application/json

404

Organization not found or access denied

application/json

429

Too many requests

500

Internal server error

application/json

post

/api/v1/organization/oauth/clients/create

HTTPcURLJavaScriptPython

POST /api/v1/organization/oauth/clients/create HTTP/1.1
Host: blynk.cloud
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 85

{
  "orgId": 101,
  "name": "My IoT App",
  "redirectUrls": [
    "https://myapp.com/oauth/callback"
  ]
}

{
  "orgId": 101,
  "name": "My IoT App",
  "clientId": "oa2-client-id_s5XUlzvfaQL8BVkteN6DuIdUxdX7u0lJ",
  "secret": "xDG7p4mu4J37P4aoa0TXCFr1hii35j_775S-2dKs",
  "redirectUrls": [
    "https://myapp.com/oauth/callback"
  ]
}