Onboard a new customer in one shot

Creates org (trial 30d), first factory, magic-link signup invite, and queues a pre-flashed-edge shipment for ops. Returns the invite link so the operator can share via Lark/WhatsApp if email bounces.

Authorization

bearer

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

customerEmail*string

Customer contact email — receives the magic-link signup

companyName*string

Customer company name — becomes the organization name

factoryName*string

First factory name (will inherit company name if omitted)

machines*array<>

Machine archetype mix — drives the synthetic demo seed customers see in their dashboard until the real edge connects

onBehalfOfAccountManagerId?string

On-behalf-of: account_manager userId to assign as the customer owner. Only honored when the caller is xentr_platform_owner — account_managers self-assign automatically.

partnerTag?string

Optional partner / reseller tag — recorded on the org for revenue attribution. Free-text today; later promoted to a partners table.

Response Body

`application/json`

curl -X POST "https://api.xentr.ai/admin/onboard" \  -H "Content-Type: application/json" \  -d '{    "customerEmail": "plant.manager@acme-precision.com",    "companyName": "Acme Precision Mfg",    "factoryName": "Detroit Plant",    "machines": [      {        "archetype": "cnc",        "count": 4      },      {        "archetype": "mill",        "count": 2      },      {        "archetype": "andon",        "count": 1      }    ]  }'

{
  "organizationId": "string",
  "organizationSlug": "string",
  "factoryId": "string",
  "factorySlug": "string",
  "inviteLink": "string",
  "trialEndsAt": "2026-05-26T14:30:00.000Z",
  "pendingShipmentId": "string"
}

Authorization

Request Body

Response Body

201application/json

`application/json`