Skip to main content
When a user signs up for accounting in your platform, create a corresponding business in Thred.
1

Prepare business information

Collect the required data from your user:Required fields:
  • legal_name - Business legal name
  • entity_type - Business entity type (validation depends on country)
  • email - Business contact email
  • country - ISO 2-letter code (GB, DE, FR, NL, ES, BE, IT, IE, AT, PT, SE, NO, DK, FI, IS)
  • currency - ISO currency code (GBP, EUR, USD)
Business entity type validation: GB, DE, NL, ES, and BE require specific business entity type codes. All other countries accept any value.See complete business entity type reference
Optional fields:
  • external_id - Your internal user/business ID (recommended for idempotency)
  • registration_number - Company registration number
  • vat_number - VAT/tax ID
  • address - Business address object
2

Call the Create Business API

POST to /v1/platform/businesses/ with a partner-scoped token:
POST https://dev-backend.thredfi.com/v1/platform/businesses/
Authorization: Bearer {partner_token}
Example payload:
{
  "external_id": "user-12345",
  "legal_name": "Acme Ltd",
  "entity_type": "limited",
  "email": "[email protected]",
  "country": "GB",
  "currency": "GBP"
}
See Create Business API endpoint
3

Store the business_id

Save the returned business_id in your database:
{
  "id": "964f4325-3efb-400d-a1bd-8b1f29e828cf",
  "legal_name": "Acme Ltd",
  "entity_type": "limited",
  "country": "GB",
  "currency": "GBP",
  "is_active": true
}
Map this to your user record:
user.thred_business_id = response["id"]
user.save()
4

Get business-scoped token

Exchange your partner token for a business-scoped token:
POST https://dev-backend.thredfi.com/v1/platform/{business_id}/oauth2/token/
Authorization: Bearer {partner_token}
Store the returned token for API calls and frontend SDK.See Authentication guide

​
Idempotency

Use external_id to prevent duplicate businesses.If you retry with the same external_id, Thred returns the existing business instead of creating a new one. This is safe for network failures and retries.

​
What Happens After Creation

Thred automatically:
  1. Sets up chart of accounts (based on business entity type and country)
  2. Initializes accounting periods
  3. Creates default tax configurations
  4. Prepares the accounting UI for embedding
Your user can now access the embedded accounting interface.
Business created. Now set up authentication to secure API access.