---
title: "List an app listing's connect-time inputs"
method: GET
path: "/app-listings/{slug}/connect-inputs/"
tags: ["app-listings"]
---

# List an app listing's connect-time inputs

`GET /app-listings/{slug}/connect-inputs/`

## Request

- Base URL: `https://api.getoneprofile.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getoneprofile.ai/app-listings/{slug}/connect-inputs/`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Return the per-customer inputs (tenant address, region, or a choice) the connect modal collects before the OAuth redirect. Empty for one-click listings.

## Path parameters

- `slug` string, required

## Response `200`

Successful Response

- AppListingConnectInputsResponseSchema: The connect-time inputs an app listing collects before the OAuth redirect.
  - `inputs` ConnectInputSchema[], required: Empty for listings that connect in one click (no per-customer inputs).
    - `default` string, nullable
    - `helper` string, required
    - `kind` 'tenant' | 'choice' | 'region', required: The kind of a connect-time input the connect modal renders.
    - `label` string, required
    - `name` string, required
    - `options` ConnectInputOptionSchema[], nullable
      - `label` string, required
      - `value` string, required
    - `placeholder` string, required
    - `required` boolean, required

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: App listing not found
- `422`: Invalid request made to the API.
- `500`: Internal server error.
- `502`: Bad gateway error.
- `503`: Service unavailable.

---

[API](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile.md) · [All operations](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/llms.txt) · [OpenAPI document](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/revisions/4a6bd71e3f02?raw)