Create Account
POST
/accountsCreate a new account within your organisation.
Accounts let you divide your organisation into separate financial entities.
Each account can have its own events, users, and reporting-perfect for
multi-promoter platforms, venues with multiple departments, or arts
organisations managing different programmes.
New accounts start empty. You'll need to invite users and assign them roles
before they can start creating events.
When to use this
- Onboarding a new promoter to your platform
- Creating a separate division for a new programme or venue space
- Setting up isolated environments for different teams
Request Body
name*stringAccount name
status"active" | "inactive"Account status
Response
Account created successfully
Notes
ℹ️Each account is financially isolated-events and revenue are tracked separately.
💡After creating an account, use the invitation endpoints to add users.
Code Samples
Create Account using the TypeScript SDK:
import { BackstageClient } from '@ticketlayer/backstage';
const client = new BackstageClient({
organisationSlug: 'your-org',
});
client.setAccessToken('YOUR_ACCESS_TOKEN');
// Create account
const account = await client.account.create({
name: 'New Account',
// Add other required fields
});
console.log(`Created account with ID: ${account.id}`);