---
title: "OAuth Verification"
method: POST
path: "/api/v2/{portalId}/submission/oauth/{provider}/verify"
tags: ["Submission"]
---

# OAuth Verification

`POST /api/v2/{portalId}/submission/oauth/{provider}/verify`

## Request

- Base URL: `https://portal-api.magna.so`
- URL: `https://portal-api.magna.so/api/v2/{portalId}/submission/oauth/{provider}/verify`
- Auth: none declared

Verifies the OAuth flow for a given provider to associate with an airdrop participant.

## Path parameters

- `portalId` string, uuid, required
- `provider` string, required

## Request body

- object
  - `authorizationCode` string, required: OAuth authorization code
  - `state` string, required: OAuth state parameter
  - `codeVerifier` string, required: code verifier for PKCE flow

## Response `200`

200

- object
  - `account` object, required
    - `value` string, required: eligible account value
    - `type` 'EMAIL' | 'X_HANDLE' | 'WALLET' | 'DISCORD', required: eligible account type
    - `isEligible` boolean, required: whether the account is eligible
    - `description` string, nullable, required: optional description for the account eligibility

## Other responses

- `400`: Client Error
- `500`: Server Error
- `502`: Upstream Error — the portal configuration service could not be reached. Safe to retry.

---

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