Create a managed account

​

Creates a CardNexus account for a seller who isn't on CardNexus yet, and connects it to your application in one step. Only available to applications CardNexus has granted the managed-account privilege.

The account is created staged: you can sync inventory into it immediately, but its listings can't go live until the seller completes onboarding. Request a hosted-onboarding link with POST /v1/account/onboarding-link and send it to the seller — completing that flow (including accepting the CardNexus terms) is what takes the account live.

If the email already belongs to an account, this fails with ACCOUNT_EXISTS — send that seller through the normal connect flow instead.

The privilege comes with a daily allowance of managed accounts. Once your application has used it up, this fails with QUOTA_EXCEEDED until the allowance resets at midnight UTC.

Body
required
application/json
  • country
    Type: string
    min length:  
    2
    max length:  
    2
    required

    The seller's country, as a two-letter ISO 3166-1 alpha-2 code (e.g. FR, US). Must be a country CardNexus supports for selling.

  • email
    Type: string Format: email
    required

    The seller's email address. They'll use it to sign in and claim the account. Must not already belong to a CardNexus account.

  • username
    Type: string
    min length:  
    2
    max length:  
    32

    The seller's public handle. If you omit it, we derive one from the email address.

Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for post/accounts
curl https://public-api.cardnexus.com/v1/accounts \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "email": "",
  "username": "",
  "country": ""
}'

{
  "accountId": "65f3a2b1c8d4e9f7a6b5c4d3",
  "username": "north_arena_tcg",
  "status": "staged"
}

The account was created.