Headless signup (API-only path)

Create a complete gigstack account end-to-end without the alphav2 web UI.
Designed for AI agents and partner integrations: a single call provisions
a Firebase Auth user, billing account, team, plan subscription, and returns
live + test API keys.

Auth: This endpoint authenticates with X-Internal-API-Key (partner-issued),
NOT a normal Authorization: Bearer API token. Bearer tokens are scoped to a
team — a brand-new caller has none yet.

Idempotency: Idempotency-Key header (UUID v4) is required. Retries with
the same key return the cached response and never re-create resources.

Plan paths:

plan_id: "free" — direct Firestore write, no Stripe, instant activation.

Any paid plan — uses stripe.subscriptions.create with the supplied
PaymentMethod token (off-session). No Checkout redirect. billingAccount.haveAPIAccess
is set synchronously so the API gate passes on the first call.

RFC and FIEL: not required at signup. Defaults to RFC genérico
(XAXX010101000). Customers can later upload their own via
POST /v2/teams/{team_id}/sat-connection. Clients, payments, services,
receipts, and webhooks all work without FIEL.

API keys: returned in the response body once — not retrievable later.
The caller must store them immediately.

curl --location 'https://api.gigstack.io/v2/auth/signup' \ --header 'X-Internal-API-Key;' \ --header 'Idempotency-Key;' \ --header 'Authorization: <api-key>' \ --header 'Content-Type: application/json' \ --data-raw '{ "email": "agent@example.com", "name": "Agent Builder Inc", "rfc": "XAXX010101000", "country": "MEX", "plan_id": "agent-tier", "billing_cycle": "monthly", "stripe_payment_method": "pm_1Q...", "livemode": true, "partner_ref": "SANTIAGO-A7K9", "metadata": { "source": "my-agent-cli" } }'

{ "user_id": "aJGZiWGWQGfZEZk9XbtShj3pxBx2", "team_id": "team_xxx", "billing_account_id": "ba_xxx", "subscription": { "id": "sub_1Q...", "status": "active", "current_period_end": 1740000000 }, "api_keys": { "live": "eyJhbGciOi...", "test": "eyJhbGciOi..." }, "next_steps": { "fiel_upload_url": "POST /v2/teams/{team_id}/sat-connection", "manifest_sign_url": "POST /v2/teams/{team_id}/manifest/sign", "note": "RFC and FIEL only required for CFDI invoicing. Clients, payments, services, receipts, and webhooks all work without them." } }

Headless signup (API-only path)

Request

Responses