---
title: "Provision a sandbox account + sk_test_ key"
method: POST
path: "/api/v1/signup"
tags: ["Auth"]
---

# Provision a sandbox account + sk_test_ key

`POST /api/v1/signup`

## Request

- Base URL: `https://swiftsign.ca`
- URL: `https://swiftsign.ca/api/v1/signup`
- Auth: none required

Unauthenticated. One call creates an account and returns a TEST key so an agent or curl is productive immediately. No browser required. Creating an account constitutes acceptance of the Terms of Service at /legal/terms and acknowledgement of the Privacy Policy at /legal/privacy.

## Request body

- SignupBody
  - `email` string, email, required
  - `name` string

## Response `201`

Account created.

- SignupResult
  - `api_key` string, required: The plaintext secret — shown once, never again.
  - `mode` 'test' | 'live', required
  - `key` ApiKeyView, required
    - `id` string, required
    - `name` string, nullable, required
    - `mode` 'TEST' | 'LIVE', required
    - `prefix` string, required
    - `last4` string, required
    - `scopes` string[], required
    - `createdAt` string, required
  - `message` string, required
  - `verify_url` string, uri, required
  - `docs_url` string, uri, required
  - `terms_url` string, uri, required
  - `privacy_url` string, uri, required

## Other responses

- `409`: An account with this email already exists.
- `429`: Too many signups from this IP.

---

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