---
title: "List your OAuth apps"
method: GET
path: "/v1/connect/oauth-apps"
tags: ["Connect"]
---

# List your OAuth apps

`GET /v1/connect/oauth-apps`

## Request

- Base URL: `https://zernio.com/api`
- URL: `https://zernio.com/api/v1/connect/oauth-apps`
- Auth: HTTP bearer

Lists your own OAuth apps on social platforms. Add as many as you need, any number per platform.

A connect runs on one when it passes its id as `oauthAppId`. The consent screen then shows your app's name and logo, and the platform's rate limits and quotas are your app's.

Also lists, in `platforms`, which platforms accept your own app and what to set up on each.

Pages are ordered by id: pass `pagination.nextCursor` back as `cursor` until it is null.

Like every OAuth-app call, it needs the account owner or a full-access team member, on a session or a full-scope API key.

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

Your apps, and the platforms that accept one.

- object
  - `apps` OAuthApp[], required
    - `id` string, required: Pass it as `oauthAppId` on GET /v1/connect/{platform} to connect through this app.
    - `platform` string, required: The platform the app belongs to, as in GET /v1/connect/{platform}.
    - `label` string, required
    - `clientId` string, required: The client ID (or app ID) of your app on the platform. The secret is never returned.
    - `scopeAreas` string[], required: The permission areas every connect through this app requests. Pick only what your app is approved for on the platform.
    - `status` 'ok' | 'unchecked' | 'invalid', required: `ok`: the platform accepted the keys at the last check. `unchecked`: the check could not reach a verdict (see lastError). `invalid`: the platform rejected the keys; connects and token refreshes through this app will fail until the secret is rotated.
    - `lastCheckedAt` string, date-time, nullable
    - `lastError` string, nullable
    - `accountCount` integer, required: Connected accounts currently running on this app.
    - `redirectUri` string, uri, required: The OAuth redirect URI to allow in your app's settings on the platform.
    - `webhook` object, nullable: Facebook and Instagram only; null on platforms with nothing to set up. Meta delivers comments and messages to your app's own webhook. Set this callback URL and verify token on the app's webhook product (Page for Facebook, Instagram for Instagram) and subscribe the listed fields. Zernio checks each delivery against your app secret.
      - `callbackUrl` string, uri, required
      - `verifyToken` string, required
      - `object` 'page' | 'instagram', required: The webhook object to configure.
      - `fields` string[], required: Subscribe the app to these fields.
    - `sharedWebhookUrl` string, uri, nullable: TikTok only: set this as the webhook callback URL in your TikTok developer app. TikTok uses it to report when a video finishes publishing; Zernio also checks the publish status itself, so posting works without it. Null on other platforms.
    - `hasSlackSigningSecret` boolean: Slack only: whether the signing secret of your Slack app is saved. Without it Zernio refuses every event sent to `slackEvents.requestUrl`.
    - `slackEvents` object, nullable: Slack only; null on other platforms. Slack delivers messages and mentions to your app's own Request URL. Save the app's signing secret first (`slackSigningSecret`), then set this Request URL under Event Subscriptions and subscribe the listed bot events. Zernio checks each delivery against that secret.
      - `requestUrl` string, uri, required
      - `botEvents` string[], required: Subscribe the app to these bot events.
    - `createdAt` string, date-time, required
  - `pagination` object, required
    - `nextCursor` string, nullable, required: Null on the last page.
  - `platforms` OAuthAppSetup[], required
    - `platform` string, required
    - `redirectUri` string, uri, required: Allow this OAuth redirect URI in your app on the platform.
    - `coreScopes` string[], required: Requested on every connect, whatever areas the app enables.
    - `scopeAreas` object[], required: The areas an app on this platform can enable, each with the scopes it requests.
      - `area` 'posting' | 'analytics' | 'comments' | 'messaging', required
      - `scopes` string[], required

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid API key. `code` is `missing_credentials` when no Authorization header was sent and `invalid_credentials` when the key is unknown, revoked or expired.

## Changes

- **2026-10-29** `134756fb8dc2`: 2 info
  - added the optional property `apps/items/hasSlackSigningSecret` to the response with the `200` status
  - added the optional property `apps/items/slackEvents` to the response with the `200` status
- **2026-10-29** `1b0c783e7f44`: 1 info
  - added the optional property `apps/items/sharedWebhookUrl` to the response with the `200` status
- **2026-10-28** `0ef14b964717`: 3 info
  - added the optional property `apps/items/webhook` to the response with the `200` status
  - removed the `ads` enum value from the `apps/items/scopeAreas/items/` response property for the response status `200`
  - removed the `ads` enum value from the `platforms/items/scopeAreas/items/area` response property for the response status `200`
- **2026-10-28** `9f1c5346e670`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/connect/oauth-apps/get.md)

---

[API](https://skmtc.dev/zernio/apis/zernio-api.md) - [All operations](https://skmtc.dev/zernio/apis/zernio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zernio/apis/zernio-api/revisions/c319eb5d95b6?raw)