Docs
Add Account
POST /events/{eventId}/accounts
POST
/events/{eventId}/accountsRequired Tokens
| Field | Type | Required | Description |
|---|---|---|---|
| Bearer | Authorization: Bearer <api-key> | Optional | Your API key. Pass it as the Bearer token on every request. |
| Event token | x-Event-Token | Optional | Run **Get Tokens** in the Authorization folder, or call `GET /Events/{eventId}/authorize` manually. |
Creates a new account on the event. Accounts are named buckets used to organize the event's finances. Once created, transactions can be linked to an account as either debit (source) or credit (destination).
Requires EventAccountingAdmin permission on the event.
Path Parameters
| Field | Type | Required | Description |
|---|---|---|---|
| eventId | Guid | Required | The ID of the event. |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| name | string | Required | The display name for the account. Must not be empty. |
Example Request
{
"name": "Production Budget"
}
Response
201 Created — No response body.
Error Codes
| Code | HTTP Status | Description |
|---|---|---|
UNAUTHORIZED | 401 | Missing or invalid token, or caller lacks EventAccountingAdmin. |
BAD_REQUEST | 400 | Name is empty or invalid. |