Skip to content
Wink

Create Application

POST
/api/managing-entity/{managingEntityIdentifier}/application
 
curl --request POST \
  --url https://api.wink.travel/api/managing-entity//application \
  --header 'Content-Type: application/json' \
  --header 'Wink-Version: 2.0' \
  --data '{ "name": "", "ownerIdentifier": "", "ownerName": "", "redirectUris": [ "" ], "postLogoutRedirectUris": [ "" ], "clientType": "WEB", "scopes": [ "" ] }'

Create a new application

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
managingEntityIdentifier
required
string
""

Identifier of the managing entity that will own the application

Header Parameters

Section titled “Header Parameters ”
Wink-Version
string
default: 2.0.0
Allowed values: 2.0

Request Body required

Section titled “Request Body required ”
Media type application/json
object
name
required

Name of the application.

string
"" >= 1 characters
Example 
App 1
ownerIdentifier
required

Owner ID.

string
"" >= 1 characters
Example 
company-1
ownerName
required

Text representation of the value.

string
"" >= 1 characters
Example 
AffiliateAccount 1
redirectUris
Array<string>
postLogoutRedirectUris
Array<string>
clientType

Type of OAuth2 client. WEB (default) uses client secret auth. MOBILE uses PKCE with rotating refresh tokens.

string
""
Allowed values: WEB SPA MOBILE MACHINE_2_MACHINE
Example 
WEB
scopes
Array<string>
unique items

Responses

Section titled “ Responses ”

201

Section titled “201 ”

Created

Media type application/json
object
id
required

Unique identifier.

string format: uuid
"" >= 1 characters
ownerIdentifier
required

Unique owner record identifier

string format: uuid
"" >= 1 characters
ownerName
required

Name of company owner.

string
"" >= 1 characters
name
required

Name of this customization application. The first customization for every integrator will have the same name as its company name.

string
"" >= 1 characters
redirectUris
Array<string>
postLogoutRedirectUris
Array<string>
clientId
required

Client identifier used to authenticate an Oauth2 or web component request.

string
""
secretKey
required

Password used to authenticate an Oauth2 request.

string
""
Example 
{
  "id": "",
  "ownerIdentifier": "",
  "ownerName": "",
  "name": "",
  "redirectUris": [
    ""
  ],
  "postLogoutRedirectUris": [
    ""
  ],
  "clientId": "",
  "secretKey": ""
}

400

Section titled “400 ”

Bad Request

object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
Example generated
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "https://example.com",
  "properties": {
    "additionalProperty": "example"
  }
}

401

Section titled “401 ”

Unauthorized

Media type */*
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties

403

Section titled “403 ”

Forbidden

Media type */*
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties

500

Section titled “500 ”

Internal Server Error

object
Example generated
{}