---
title: "Validate Connect token"
method: GET
path: "/v1/connect/tokens/{ctok}/validate"
---

# Validate Connect token

`GET /v1/connect/tokens/{ctok}/validate`

Confirm the validity of a Connect token

## Path parameters

- `ctok` string, required — An authentication token with a limited lifespan

## Query parameters

- `app_id` string, required
- `account_id` string
- `oauth_app_id` string

## Response `200`

connect token validated

- ValidateTokenResponse — Response received when validating a connect token
  - `app` App — Response object for a Pipedream app's metadata
    - `id` string, nullable — ID of the app. Only applies for OAuth apps.
    - `name_slug` string, required — The name slug of the target app (see https://pipedream.com/docs/connect/quickstart#find-your-apps-name-slug)
    - `name` string, required — The human-readable name of the app
    - `auth_type` 'keys' | 'oauth' | 'none', nullable — The authentication type used by the app
    - `description` string, nullable — A short description of the app
    - `img_src` string, required — The URL to the app's logo
    - `custom_fields_json` string, nullable, required — A JSON string representing the custom fields for the app
    - `categories` string[], required — Categories associated with the app
    - `featured_weight` number, required — A rough directional ordering of app popularity, subject to changes by Pipedream
    - `scope_profiles` object[], required — Named subsets of the app's OAuth scopes that may be requested when users connect their accounts (via the `oauth_scope_profile` parameter). Empty for apps that don't define any.
      - `name` 'read_only' | 'read_write' | 'admin', required — The profile name. Pass this back as `oauth_scope_profile` when starting the OAuth flow for this app.
      - `scopes` string[], required — The actual OAuth scopes of the upstream API that the user will be asked to authorize when this profile is selected.
  - `error` string, nullable, required — Error message if validation failed
  - `error_redirect_uri` string, nullable — URI to redirect to on error
  - `oauth_app_id` string, nullable — OAuth app ID if applicable
  - `project_app_name` string, nullable — Name of the project app
  - `project_environment` string, nullable — Environment of the project
  - `project_id` string, nullable — ID of the project
  - `project_support_email` string, nullable — Support email for the project
  - `success` boolean, required — Whether the token validation was successful
  - `success_redirect_uri` string, nullable — URI to redirect to on success

## Other responses

- `429` — too many requests

---

[API](https://skmtc.net/pipedream/apis/pipedream-rest-api.md) · [All operations](https://skmtc.net/pipedream/apis/pipedream-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pipedream/pipedream-rest-api/versions/c25dbf225c49/schema)