Authorize Account
Endpoint: PUT /accounts/authorize/{authorizationId}
Authentication: Bearer Token (required)
Description
Authorizes a pending account that was created in an unverified state. This endpoint finalizes the account creation with the provided details.
Request
Path Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| authorizationId | string | Yes | The UUID of the authorization request |
Headers
| Name | Type | Required | Description |
|---|---|---|---|
| Content-Type | string | Yes | Must be application/json |
| Authorization | string | Yes | Bearer token for authentication |
Request Body
{
"name": "Pool Suspense Account",
"description": "Suspense account for core system pool",
"alternateAccountNumber": null,
"type": "ASSET",
"category": "CURRENT",
"ledger": "GL",
"partyType": "COMPANY",
"party": "Bookshop 4",
"currencyStringId": "45588d64-43d0-43e1-a3e2-2ab4e2c56af9",
"customerStringId": null,
"companyStringId": "734a7dd8-b8ba-43df-9210-8bf0f367bca5"
}
Request Body Fields
| Field | Type | Required | Description |
|---|---|---|---|
| name | string | Yes | The name of the account |
| description | string | No | A description of the account's purpose |
| alternateAccountNumber | string | No | An alternate identifier for the account |
| type | string | Yes | The account type. One of: ASSET, LIABILITY, EQUITY, REVENUE, EXPENSE |
| category | string | Yes | The account category. One of: CURRENT, NON_CURRENT, OPERATING, NON_OPERATING |
| ledger | string | Yes | The ledger type. Must be GL (General Ledger) |
| partyType | string | Yes | The type of party associated with the account. One of: COMPANY, CUSTOMER, SUPPLIER |
| party | string | Yes | The name of the party associated with the account |
| currencyStringId | string | Yes | The UUID of the currency for the account |
| customerStringId | string | No | The UUID of the customer (required if partyType is CUSTOMER) |
| companyStringId | string | Yes | The UUID of the company that owns the account |