Create an authorization code

JSON PKCE authorize used by the SDK and sandbox walkthrough.

POST /oauth/authorize

Create an authorization code with PKCE

cURL

curl --request POST \
  --url https://api.swapnice.com/oauth/authorize \
  --header 'Content-Type: application/json' \
  --data '
{
  "response_type": "code",
  "client_id": "swa_client_01HZZZ8KQ2J9X2RW7B8Y4D2FPK",
  "redirect_uri": "https://partner.example.com/swapnice/callback",
  "code_challenge": "ImpiCd8pp4MveCNnbIS7-GXEtB0xF5HMIDoWqvGA5ig",
  "code_challenge_method": "S256",
  "customer_id": "sandbox_user_001",
  "scope": "connections:write consent:write events:write profile:read",
  "state": "sandbox-walkthrough"
}
'

200

{
  "code": "swa_code_01HZZZ9N3K",
  "state": "sandbox-walkthrough",
  "redirect_uri": "https://partner.example.com/swapnice/callback",
  "expires_in": 300
}

JSON PKCE authorize used by the SDK and sandbox walkthrough.

This is the partner-backend flow. code_challenge_method must be S256. The code expires in about five minutes and is single-use.

See authentication and the request walkthrough.

Body

application/json

response_type · enum<string> · required

Available options: code

client_id · string · required

redirect_uri · string<uri> · required

code_challenge · string · required

Required string length: 43 - 128

code_challenge_method · enum<string> · required

Available options: S256

customer_id · string · required

scope · string · required

Example:

"connections:write consent:write events:write profile:read"

state · string

Maximum string length: 512

Response

200

application/json

Authorization code issued.

code · string · required

redirect_uri · string<uri> · required

expires_in · integer · required

state · string