---
title: "Creating a Merchant Account"
method: POST
path: "/v1/auth/external/sign-up"
tags: ["JWT Authentications"]
---

# Creating a Merchant Account

`POST /v1/auth/external/sign-up`

Create a new Helio merchant account using an external authentication method.

## Query parameters

- `apiKey` string, required

## Request body

- ExternalSignUpRequest
  - `id` string — Merchant-generated unique identifier used as a stable external reference for the account.
  - `wallets` object[] — List of user wallets to associate with the sign-up request.
    - `name` string — Name or label for the wallet.
    - `address` string — Public address of the wallet.
  - `user` object — Details about the individual user signing up.
    - `email` string — Email address of the user.
    - `name` string — Full name of the user.
    - `discordUsername` string — Discord handle of the user.
    - `twitterUsername` string — Twitter handle of the user.
  - `company` object — Details about the company associated with the sign-up.
    - `name` string — Company name.
    - `email` string — Company contact email address.
    - `websiteUrl` string — URL of the company website.
    - `discordUsername` string — Company's Discord handle.
    - `address` string — Physical address of the company.
    - `phoneNumber` string — Contact phone number for the company.
    - `kycVerified` boolean — Indicates whether the company has passed KYC verification.

## Response `200`

Returns user and company details along with a redirect URL.

- PaylinkTxWithShallowEnrichedPaylink

## Other responses

- `401` — Provided API key has no access to the resource.

---

[API](https://skmtc.net/hel/apis/helio-open-api.md) · [All operations](https://skmtc.net/hel/apis/helio-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hel/helio-open-api/revisions/5732beb2d39f/schema)