Get Access Token | Kiwiform

Overview

Exchanges an authorization code or a refresh token for a persistent access token. This is the first step in interacting with the KiwiForm API.

Request Body (form-data)

Key	Type	Description
`grant_type`	`string`	Required. Use `authorization_code` or `refresh_token`.
`client_id`	`string`	Your unique Application Client ID. Required for `authorization_code`. Optional for `refresh_token`.
`client_secret`	`string`	Your Application Secret Key. Required for `authorization_code`. Optional for `refresh_token`.
`code`	`string`	Required if `grant_type` is `authorization_code`.
`refresh_token`	`string`	Required if `grant_type` is `refresh_token`.

Response Attributes

access_token (string): The token used for authentication.
refresh_token (string): Token used to obtain a new access token.
expires_in (integer): Time in seconds until the token expires.

### **Overview** Exchanges an authorization code or a refresh token for a persistent access token. This is the first step in interacting with the KiwiForm API. ### **Request Body (form-data)** | Key | Type | Description | | --- | --- | --- | | `grant_type` | `string` | **Required.** Use `authorization_code` or `refresh_token`. | | `client_id` | `string` | Your unique Application Client ID. **Required** for `authorization_code`. Optional for `refresh_token`. | | `client_secret` | `string` | Your Application Secret Key. **Required** for `authorization_code`. Optional for `refresh_token`. | | `code` | `string` | Required if `grant_type` is `authorization_code`. | | `refresh_token` | `string` | Required if `grant_type` is `refresh_token`. | ### **Response Attributes** - `access_token` (string): The token used for authentication. - `refresh_token` (string): Token used to obtain a new access token. - `expires_in` (integer): Time in seconds until the token expires.

Request

This endpoint expects an object.

grant_typestringRequired

client_idstringRequired

client_secretstringRequired

refresh_tokenstringRequired

Response

access_tokenstring

refresh_tokenstring

expires_ininteger

token_typestring

Overview

Exchanges an authorization code or a refresh token for a persistent access token. This is the first step in interacting with the KiwiForm API.

Request Body (form-data)

Key	Type	Description
`grant_type`	`string`	Required. Use `authorization_code` or `refresh_token`.
`client_id`	`string`	Your unique Application Client ID. Required for `authorization_code`. Optional for `refresh_token`.
`client_secret`	`string`	Your Application Secret Key. Required for `authorization_code`. Optional for `refresh_token`.
`code`	`string`	Required if `grant_type` is `authorization_code`.
`refresh_token`	`string`	Required if `grant_type` is `refresh_token`.

Response Attributes

access_token (string): The token used for authentication.
refresh_token (string): Token used to obtain a new access token.
expires_in (integer): Time in seconds until the token expires.

$	curl -X POST https://app.kiwiform.com/api/zapier/token \
>	-H "Content-Type: application/x-www-form-urlencoded" \
>	-d "grant_type=refresh_token" \
>	-d "client_id=abc123xyz789" \
>	-d "client_secret=s3cr3tK3y!%40%23" \
>	-d "refresh_token=rtk_9f8e7d6c5b4a3"

1	{
2	"access_token": "atk_4f3e2d1c0b9a8",
3	"refresh_token": "rtk_9f8e7d6c5b4a3",
4	"expires_in": 3600,
5	"token_type": "Bearer"
6	}