SpireStockDevelopers
DocsAPI ReferenceWebhooksAI ToolsSDKsChangelog
OpenAPI SpecGo to Dashboard

Signup API

Create a SpireStock workspace programmatically, check slug availability and complete onboarding for a new organization.

1 endpoint. Every request needs an API key or a session token — see Authentication. To send one of these calls from the browser, use the interactive reference.

POSThttps://api.spirestock.com/api/v1/signup/register

Register a new organization and admin user. Creates the workspace, default settings, and returns a JWT token.

Request body

  • first_name (string)required — First name of the admin user
  • last_name (string)required — Last name of the admin user
  • official_email (string)required — Admin email address
  • primary_contact_number (string)required — Admin phone number
  • password (string)required — Password (min 8 characters)
  • organization_name (string)required — Name of the organization/business

Example request

curl -X POST https://api.spirestock.com/api/v1/signup/register \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "Jane",
    "last_name": "Smith",
    "official_email": "[email protected]",
    "primary_contact_number": "+919876543210",
    "password": "secureP@ss123",
    "organization_name": "Acme Dairy"
  }'

Example response

{
  "response_code": 201,
  "message": "Workspace created successfully",
  "token": "eyJhbGciOiJIUzI1NiIs...",
  "user": {
    "id": 100,
    "first_name": "Jane",
    "last_name": "Smith",
    "official_email": "[email protected]",
    "role_name": "Admin",
    "user_type": 0,
    "organization_id": 10,
    "status": 1
  },
  "workspace": {
    "slug": "acme-dairy",
    "display_name": "Acme Dairy",
    "plan": "free",
    "status": 1
  }
}