---
title: "Wallet Submission"
method: POST
path: "/api/v2/{portalId}/submission/wallet"
tags: ["Submission"]
---

# Wallet Submission

`POST /api/v2/{portalId}/submission/wallet`

## Request

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

Submits a new wallet address to associate with an airdrop participant. Verifies the signed message from their wallet.

## Path parameters

- `portalId` string, uuid, required

## Request body

- object
  - `wallet` string, required: wallet address to generate a nonce for
  - `platform` 'EVM' | 'MOVE' | 'SOLANA' | 'OTHER', required
  - `message` string, required: message that was signed
  - `signature` string, required: signed message from the wallet owner

## Response `201`

201

- 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
- `401`: Unauthorized
- `409`: Conflict
- `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)